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WELCOME I MikjPi 


WELCOME 

to The MagPi 76 


I t’s the most wonderful time of the year. The time when 
lots of folks see a wild Raspberry Pi appear under the tree 
for the first time. 

And this month we’re all being treated to a brand new 
Raspberry Pi, the super-sweet new 3A+ (page 66). ’Tis the 
season to be jolly and break out the new projects (especially 
ones that need a fast, but energy-efficient small computer). 

If you’re new to Raspberry Pi, then let me be the first to 
welcome you to the party. Grab some cake and help yourself 
to a drink! 

Our Raspberry Pi Superguide (page 28) gives newcomers 
the all-star treatment. In it you’ll find advice on how to 
set up a Raspberry Pi and get started with basic electronic 
components. You’ll also learn how to set up simple projects 
like a retro gaming console and home theatre PC. It’s proper 
computing with pins and programming. 

Enjoy the party! 


Lucy Hattersley Editor 


f YOUR OFFICIAL 


raspbeb" ypiMAWZINE 



Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangLes the piano. 
One day she'll get 
that pet dog. 

magpi.cc 
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DISCLAIMER: Some of the tooLs and techniques shown in The MagPi magazine are dangerous unless used with skill experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you compLy with them. Some manufacturers pLace Limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's Limits. 
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kitten 


A A Raspberry Pi and NyBoard 
are used to make decisions 
and control the cat's legs 


Nybble: 

the open-source 


Raspberry Pi robotic cat leaps onto Indiegogo. By Lucy Hattersley 



B ack in TheMagPi issue 68 (magpi.cc/68) we 
reported on OpenCat, a Raspberry Pi-based 
project by Chinese roboticist Rongzhong Li. 
Fulfilling his dream to make the project self- 
supported, OpenCat has been renamed Nybble and 
Li has taken it to Indiegogo (magpi.cc/FtXeeb). 

“Nybble is the lightest and fastest robotic cat 
that really walks,” says Li. It's “not only a robotic 


cat that walks,” he explains, “but a new type 
of pet.” 

The robotic cat has had a complete design 
makeover, and a wooden frame of interlocking 
parts replaces the 3D-printed parts of the 
original. “The wisdom of traditional Chinese 
woodwork was borrowed to make the major 
frame screw-free,” writes Li. 


A The wooden frame is 

designed to be assembled 
without using screws 
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An Arduino-compatible controller called 
NyBoard Vo is used to handle the motion of 
Nybble’s legs. NyBoard sits on top of a Raspberry 
Pi, which controls higher-level functionality, such 
as “perception and decision-making,” says Li. 

The OpenCat software is being developed with 
community support, and you can take a look at it 
onGitHub: magpi.cc/rThMwm 

Serious cat 

Don’t be fooled by the project’s cute appearance: 
Nybble aims to grab the attention of a serious 
robotics audience. Getting Nybble to walk may not 
be as straightforward as many users imagine, and 


□ We can break the barrier bet\ 
those million-dollar quadrupe 
robots and individual makers 


A Nybble is one of 
the cutest robotics 
projects around 


▼ Nybble hopes to break down the barrier 
between individual makers and million-dollar 
quadruped projects like Boston Dynamics' Spot 


with eleven servos it should be capable of complex 
movement. Nybble is adorable, but it aims to be a 
“precise instrument”. Users will need to calibrate 
the limbs, for example. 

Li draws comparison between Nybble and 
high-profile robotics projects like those 
from Boston Dynamics (who build terrifying 
quadrupeds such as Spot and SpotMini). 

“We know that with Nybble, we can break the 
barrier between those million-dollar quadruped 
robots and individual makers,” says Li. “Nybble 
will also be less intimidating to kids who want to 
learn about robotics, programming, and making 
in general.” 

Nybble has met its Indiegogo target, so the 
project is funded and we look forward to seeing 
it in action, 
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Raspberry Pi 

in £78m computing 
education boost 


► 


Teachers will get reso 
training, research, and 
certification as part 
of the programme 


Dedicated funding for Raspberry Pi to transform UK 
computing education. By Rosie Hattersley 


C omputing education in England is about to 
get a much-needed jolt of funding with the 
help of the Raspberry Pi Foundation. 

The welcome cash injection comes a year 
after The Royal Society reported that there was a 
( once-in-a-generation opportunity’ to transform 

□ A once-in-a-generation opportunity to 
transform the way computing is taught 
in schools and colleges □ 

the way computing is taught in schools and 
colleges. Commenting on the report, Raspberry Pi 
Foundation CEO Philip Colligan noted that “there’s 
a long way to go before we can say that young 
people are consistently getting the computing 
education they need and deserve in UK schools.” 


The Raspberry Pi Foundation is one of 
the organisations that, jointly, have secured 
£78 million in UK government funding to 
make this vision a reality. 

The Foundation is part of a consortium 
that also includes STEM Fearning and the 
BCS (British Computer Society). Google has 
also pledged £1 million to support free online 
computing and computer science courses 
accessible to anyone. 

While existing computing and ICT 
(information and communications technology) 
teachers are being directly targeted, the scheme 
will also upskill existing teachers in other 
disciplines to teach GCSE Computer Science. 

Philip explains that the money will be used 
“to make sure every child in every school 
in England has access to a world-leading 
computing education. ” 
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A A RoyaL Society report last November 
drew attention to the scale of the 
challenge in transforming the way we 
teach computer science in the UK 


The consortium will found a new National Centre 
for Computing - with a network of computing 
hubs where existing primary and secondary school 
computing teachers in England will be able to take 
part in fully funded CPD (continuing professional 
development) courses. Teachers will also have 
access to free resources enabling them to teach 
computing to students from Key Stage l right up 
to A-Level. 

As part of an all-hands-on-deck approach 
to overhauling computing teaching in England, 
the Raspberry Pi Foundation and its consortium 
have more than 60 organisations signed up to offer 
practical assistance and expertise. Businesses, 
universities, and non-profit organisations are 
pooling their expertise and resources to provide 
the support that educators and schools require. 

You can learn more, and get involved, 
at teachcomputing.org EH 



Raspberry Pi in £ 78 m computing education boost | magpi.cc | 09 





McitfPi I THE WORLD OF PI 


Raspbian updated 

New version of Raspberry Pi OS features VLC and Thonny version 3. By Lucy Hattersley 


R aspberry Pi has updated Raspbian 

alongside its launch of the new Pi 3A+ 
computer. The latest update (2018-11-13) 
introduces major new features, and a host of 
under-the-hood tweaks. 

A new hardware-accelerated version of VLC 
media player enables media playback on the 
Raspberry Pi. It’s been a “glaring omission 55 
according to Simon Long, the Software Engineer 
at Raspberry Pi responsible for Raspbian. 

“Windows has Windows Media Player, macOS 
has QuickTime Player and iTunes, but we’ve had 

□ Major new features, and a host 
of under-the-hood tweaks □ 

a big hole where something similar ought to be 
for Raspbian, 55 writes Simon on the Raspberry Pi 
blog (magpi.cc/bavZxx) 

VLC is a powerful piece of software that can play 
(or stream) virtually any video or audio file. “It 



A A hardware-accelerated version of VLC media player enables 

powerful media playback on Raspberry Pi 

uses software codecs for many video formats, 55 
reports Simon, and “VideoCore’s video engine 
to accelerate playback of H.264, MPEG-2, and 
VC-i video. 55 The software is free, but users will 
need to buy additional licences to play MPEG 
and VC-i video. 

Thonny, the standard Python IDE 
(integrated development environment) included 
with Raspbian, has been updated to version 3 
(thonny.org). The new edition introduces 
welcome features such as Breakpoints and a 
code-analysing Assistant. 



A Thonny version 3 introduces Breakpoints 
and a code-analysing Assistant to help 
you debug your programs 



Recommended software 

Raspberry Pi has chosen to create three OS 
images this time: Raspbian Stretch with Desktop 
and Recommended Software (also known as 
‘Raspbian Full 5 ), Raspbian Stretch with Desktop, 
and Raspbian Stretch Lite (which does not feature 
the desktop interface). 

Raspbian Full includes familiar extra programs 
such as LibreOffice, Scratch, Sonic Pi, Thonny, 
and Mathematica. NOOBS will feature Raspbian 
Full as the default installation. For information 
on using NOOBS to set up a Raspberry Pi, take a 
look at our QuickStart guide (magpi.cc/quickstart). 

Both images are available for download from 
the Raspberry Pi website (rpf.io/downloads). 

To update an existing Raspbian image, open 
a Terminal window and enter: 

sudo apt-get update 

sudo apt-get dist-upgrade 

sudo apt-get install vie E3 


10 | magpi.ee | Raspbian updated 



















3 ISSUES 

FROM £5 

on a quarterly subscription 



^^^ScprERRYPI magazine 
your 0FF!C |AL r .— -iBiHlllifSS 


OFFICIAL RASPBERW PI MAGAZINE 




goon^ox 


BaS pberry 




Use the code MP-SAVE at checkout 


Visit: magpi.cc/345 


magpi.cc | 11 













MAKER 



As We Are 



Matthew Mohr 
& Mac Pierce 


Matthew is an artist 
who came up with 
the idea for As We 
Are, and Mac Pierce 
is the creative 
technologist that 
heLped make 
it a reality. 

magpi.cc/UjTkbW 


Ever wanted your face to be 14-foot high? Now you can with this sculpture 
covered in LEDs and powered by many, many Pi boards, Rob Zwetsloot 
tries to get his head around it 


I magine walking through the doors of a 
convention centre and seeing someone’s 
face staring down at you. Not just in statue 
form, or even on a big TV either - no, this is a 
14 ft (4.3 m) high sculpture of a head, covered in 
LEDs that are hooked up to a load of Raspberry 
Pi boards to display a face. That must be 
somewhat disconcerting. 

“The idea was concepted and artistically 
directed by Matthew Mohr,” Mac Pierce, the 
production manager of the piece, tells us. “It 
was commissioned by the Greater Columbus 
Convention Center (columbusconventions.com) 
as the centrepiece of their new collection 
of local art.” 

It’s certainly striking. One feature that is easy to 
miss is the Pi-powered photo booth that is inside 
the head, allowing people to get their face scanned 
and the images 3D-mapped to the screens. It’s not 
just showing off famous people, or even Matthew 


the creator, but instead folks around you, or 
yourself. Mac opted to use Raspberry Pi boards in 
the booth after researching the standard solutions. 

“Looking at network-attachable cameras, 
none of the versions we found would work for 
our application,” says Mac. “Either they were 
scientific or industrial inspection cameras that 
required complex lensing and large mounting 
requirements - not to mention being prohibitively 
expensive - or they had impenetrable APIs and 
closed software that would limit their usefulness. 
The Pi 3 and Camera Module combo ended up 
fitting nicely for our application, as the camera 
could be mounted separate from the main body 
of the Pi, which allowed the overall size of the 
booth to have a lot less wasted space. The Pis 
could also be easily attached to the network, and 
were open so that custom programs could be 
written on it to handle the photo processing and 
network handling. ” 


!».U 

















> Creating maps in 
this way takes a Lot 
of computing power 

> The setup 
specifically uses a 
v 2 Camera Module 

> The head is built on 
castors which allow 
it to be rotated and 
moved easily 
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PROJECT SHOWCASE 


McujPi 


Mac explains, “The overall sculpture 
itself is built around an aluminium frame 
that gives the piece structure and [enables] 
mounting of the LEDs. The LEDs themselves 
were custom-manufactured by Sansi North 


□ One feature that is easy to miss 
is the Pi-powered photo booth 
that is inside the head □ 


America (snadisplays.com) to be able to 
form the curved layers of the head with only 
minimal faceting. The autonomous system of 
the scanning is done through a series of large 
processing servers, a half-rack of which exists 
in the top of the head, and another full rack that 
operates remotely.” 




▼ CLose up, you can see aLL 
the LED banks used to 
create the head image 



A These are individual 
LEDs, not just screens 
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While you may be distracted by the head 
sculpture itself, make sure to walk around 
behind it to find a curtain. Walk through it to find 
where the magic happens. 


Follow the on-screen instructions to take the 
perfect photo (or 30). These pictures are then 
sent to be processed by a server above you, and a 
server elsewhere. 




Head back outside and you’ll soon see your 
face looking back at you. Now’s a perfect time 
to take a selfie of yourself with yourself. 


The photo booth part operates via a touchscreen 
which guides the users on where to look and how 
to place their head for an optimal result. The 
Raspberry Pi boards then take the photos required 
by the servers. 

See your reaction 

The project has received a fair bit of attention, with 
one person calling it the ‘Ultimate Selfie Machine’, 
and it continues to operate in the Columbus 
Convention Center, where it remains open to the 
public. It even turns around to look out at the 
street at night. 

As for future projects, projection mapping has 
taken Mac’s interest: “I’m right now looking at 
a few different versions of projection-mapping 
software that runs on a Pi, which would make it 
perfect for permanently installed projection pieces. 
Also, there are a wealth of applications for the Pi 
in digital signage, of which I’m hoping to do some 
projects with soon.” ED 


► It takes a Lot of Raspberry Pi 
boards to capture enough 


Your face on the big screen 
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Working Model 
of the Trinity Buoy 


Wharf Lighthouse 

Building ten working models of a lighthouse for your 
wedding day is a hugely impressive feat - Nicola King 
shines a light on an ambitious project 


I 



Dave 


Dave has a Lot of Pi- 
related experience, 
including attaching 
a Pi to his Roomba 
so he could record 
time-lapse videos 
of it hoovering 
the flat. 

magpi.cc/BZVvgm 


^ Concealed in the 
base are a Pi Zero, 
battery, motor board, 
and LCD; the wiring 
proved challenging 

► A production Line of 
Lighthouses, ready for 
the big day 


W hen Dave knew that he would be getting 
married in a unique London lighthouse, 
he decided to make some very original 
wedding table centrepieces: working models of the very 
lighthouse in which the nuptials were taking place. Not 
only that, but he resolved to make ten of them - quite 
an undertaking. As Dave explains, “With my love of 3D 
printing, Raspberry Pis, and needlessly complicated 
projects, recreating the lighthouse as a working model 
seemed like the way to go. ” 

Buoy oh buoy! 

Over a three- to four-month period, before his 
August 2018 wedding, Dave designed, 3D-printed, and 
completed the models with, unsurprisingly, “the last 
month being pretty non-stop. ” 

A time-consuming project, modelling the lighthouse 
necessitated a lot of work, and Dave used many 
photographs of the real-life lighthouse to guide his 
progress. In addition, as he explains, “The software I 
used on the Pi was pretty simple, although I tweaked 
it a few times. The two most challenging parts were 
fitting in all the printing time, and the mechanism for 
the rotating light. I went through a couple of major 
versions of that, a lot of minor versions, and still 
never got it 100% reliable - turns out rotating and 
maintaining a circuit is quite hard!” 

The 3D printing time was indeed considerable, as 
each model required 44 hours of printing in order to 
produce the six key pieces: outer, inner, railing, cap, 
base, and base lid. 

In terms of function, the models include an 18650 
battery (in a shield), a Raspberry Pi, and an LCD display 
in the base. At the top is a warm white LED light on 
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Quick FACTS 


> The Lighthouse model 
was designed in 
Autodesk 123D 


> Dave used his Prusa 
MK2.5 to 3D-print 
components 


> Trinity Buoy Wharf is 
the site of London’s 
only Lighthouse 


The body and five other 
parts took 44 hours to 
3D-print for each model 


> Ajam-jar is used for 
the glass Light casing 

> Dave gave most of the 
models to wedding 
guests - one is now 

in Australia 


top of a stepper motor. “Wires run up the middle 
and when you turn on the battery, it powers on the 
light and the Pi,” reveals Dave. “The Pi then starts 
turning the motor (and light) and displaying various 
messages on the display. ” 

Not plain sailing 

Understandably, the project was far from 
straightforward. Dave tells us that he needed to 
tweak the wiring, and there were a number of 
adjustments to the lights. “I ended up with a factory 
line of Raspberry Pis updating themselves and then 
updating their host names on the network when 
they were done - so I could drop onto each one the 
startup script, the display script, and the motor 
script. The display script used a Python scheduler 
and pulled the bespoke messages from a JSON file, 
so I could use the same code and then drop the right 
messages file on each one. ” 

Dave's impressive model-making 
accomplishment was such an ingenious idea, 
and something that was, ultimately, very well 
received by his wedding guests, as he tells us: “I 
didn’t have much trouble giving them away, which 
was great... one is [now] in the wardroom of a 
navy minesweeper. ” 

Dave clearly has a great talent for model-making, 
but tells us that his next model project may be 
something slightly less time-consuming, “I’ll no 
doubt make some other things, but I don’t know 
what yet. I’m looking forward to making only one 
of something.” ED 


Housed in ajam-jar, 
the LED light is rotated 
by a stepper motor 
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Ecosystem 

Monitor 


w 

< 

S 


Sarab 

Sethi 


Sarab is a PhD 
student at Imperial 
College London 
working across 
the Applied 
Mathematics, 
Design Engineering, 
and Tropical 
Forest Ecology 
departments. 


magpi.cc/tFdxAg 


- 


A team of London-based scientists are using Raspberry 
Pi boards and microphones to monitor biodiversity in 
Borneo's forests, David Crookes listens in 


T ropical forests are noisy places, the air filled 
with the sounds of a wide diversity of birds 
and animals. They are also rather physically 
taxing thanks to daily thunderstorms, intense 
midday heat, and mountainous terrain. It makes 
it difficult for ecologists to perform manual field 
studies, which are thus prone to a high failure rate. 
So research postgraduate Sarab Sethi - along with 


time ecosystem monitoring device based around 
a Raspberry Pi. 

a Our particular interest was in recording audio 
to capture the soundscape - or the combination 
of all the vocalising animals - as this is a rich 
data source that can be used to track birds, 
mammals, frogs, and more,” Sarab tells us. For 
this, the scientists required a device that could 



his supervisors Prof Rob Ewers, Dr Nick Jones, 
and Dr Lorenzo Picanali - have devised a real- 


continuously record, compress, and upload huge 
amounts of data from the field while exploiting 


magpicc Jf/fc i 


'stem Monitor 
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Attached to a tree by an aluminium rod, the 
monitoring system also contains a deep 
cycle battery and mobile network dongle 


Solar panels were attached to the top 
of trees by the SEARRP climbing team 
to attract as much sunlight as possible 


Most components, including the 
Raspberry Pi, are placed within a 
small DRiBOX, with a Rode smartLav- 
lavalier mic sticking out of one end 
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► This is the view from 
underneath the solar 
panel, with everything 
firmly strapped or taped 
into place 


Quick FACTS 


> The overall system 
costs £230 to make 

> 64GB can store 
a month of 
animalsounds 

> The Pi boards are 
powered by 20 to 
30W solar panels 



> They’re exposed 
to temperatures 



a patchy mobile signal to remotely transfer data 
to a server. “The Raspberry Pi was ideal as a low- 
cost, relatively low-power device with a usable 
amount of computing power and large support 
for a wide range of sensors,” says Sarah. 

Jungle sounds 

With their field site in Sabah, Borneo, in mind, 
they set about creating a system that could 
monitor the effects of oil palm plantations and 
logging on the region's biodiversity by listening 
out for the sounds of animals. It involved using 
a Rdde smartLav+ microphone to provide high- 
quality audio recordings, along with an external 
USB audio card, solar energy, and a 3G dongle to 
connect to the internet. The ultimate aim is to use 
artificial intelligence to pick up on the audio and 
make sense of the data. 



For now, however, the Python-programmed 
software runs two threads concurrently: one 
continuously records data from a sensor and 
stores it in uncompressed files, and the second 
compresses this data and robustly uploads it using 
FTP to a remote server. “It is important that the 
device is networked to minimise the amount of 
times a scientist or research assistant has to go 
to visit the device to manually collect the data - 
freeing up time to be better spent on other more 
efficient and less exhausting tasks,” explains 
Sarab. “Large animals also love to play with (or 
more likely destroy) any equipment left in tropical 
forests. Continuously uploading data serves as an 
instant backup system.” 

Testing times 

The system is being tested at the Stability for 
Altered Forest Ecosystems (SAFE) project in Borneo 
where it's been up-and-running since February 
2018. It currently uses a network of twelve acoustic 
monitoring devices which are placed across a 
gradient of logging intensity, from old-growth 
untouched forest to oil palm plantations, allowing 
animals to be tracked in specific environments. 

“Our major headache has been the solar power 
system, as the quality and range of batteries 
available in this region of Malaysia is generally 
pretty poor and importing batteries across 
borders is difficult,” Sarab says. “However, the 
monitoring device itself has fared surprisingly 
well, especially considering the near 100 percent 
humidity and regular movement due to shaking 
of trees, animal interference, etc. To date, we have 
collected over 15 000 hours of audio using these 
devices, and more is coming in each day. ” ED 
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Project BoxBoom 

This modern take on a retro boombox is sure to [boom] 
shake the room, as David Crookes discovers 


Dane Hermse & 
Nicole Horward 


Dane Hermse and 
Nicole Horward 
spend much of 
their spare time 
making fun items, 
from a machine 
that automates 
goodbyes to an loT 
hamster wheel. 

magpi.cc/LwDONF 


T here were two main methods of listening to 
music back in the 1980s: privately through a 
pair of headphones and a Walkman, or at full 
blast through a portable music player so that other 
people could hear, whether they wanted to or not. 
With Project BoxBoom, Pi enthusiasts and makers 
Dane Hermse and Nicole Horward hope to evoke 
memories of the latter. <( When we found a boombox 
in a second-hand store, it instantly made me 
happy,” Dane tells us. “It reminded me of The Fresh 
Prince of Bel-Air and a colourful decade.” 

The pair had wanted to revamp old equipment 
for some time and they soon got to work on their 
new purchase. “The broad strokes of the build were 
already in my head - remove the broken parts, add 
a screen, hook up the audio, run some sort of music 
app, and add a power source,” Dane says. Hoping 
to make use of the old knobs and buttons and have 
them work with a Raspberry Pi while retaining the 
old look and feel of the original player, he envisioned 
that a touchscreen would replace the cassette deck. 

Sounds good 

After opening the old boombox, the pair first checked 
which components still worked and they looked for 
parts that could be reused. “We found everything 
was broken except for the speakers, so I went looking 
for the parts we needed,” says Dane. “This meant 
measuring what screen would fit, how much power 


▲ The screen is ready to be installed. Dane says the GPIO pins 
could be connected to control LEDs, too 

the boombox, and 3D-printed two frames to hold 
the screen. 

“Next, I soldered the amplifier chip, connected 
the speakers to the amplifier, added the Raspberry 
Pi, and hooked up the wires,” Dane explains. Here 
the Pi came into its own. “Its in-built internet 
connectivity, four USB ports, audio jack, and HDMI 
port were super-useful,” he continues. “But then 
for every project we do, the Pi is a default: you can 
do anything with them. ” 




□ When we found □ boombox in a second¬ 
hand store, it instantly made me happy □ 

the amplifier would need, and how big the power 
bank could be. I was also keen to ensure the inside 
mechanics would keep working and the outside 
stayed nice.” 

Aside from a Raspberry Pi 3 Model B, Dane 
ordered an Adafruit HDMI 5-inch 800x480 display 
backpack with a resistive touchscreen, along with 
an Adafruit TPA2012 2.1W stereo audio amplifier, 
and a 2.4 A power bank. He cleaned up the hole 
where the cassette player used to be at the front of 


Streaming ahead 

Getting a web music player to co-operate was 
trickier. “Spotify didn’t work on Chromium, which 
was something to do with Widevine digital rights 
management, but Deezer worked on the first try,” 
Dane says, explaining that SoundCloud also worked 
“Adding an on-screen keyboard extension to the 
browser meant the boombox was ready to be used. ” 
For the finishing touches, Dane converted the 
old antenna into a touchscreen stylus, painted 
the screen frames black, cleaned the entire build, 
and put the old screws back. “The most difficult 
part was to make it look nice,” he muses. “But it’s 
had very positive responses. ” Music to his (and 
everyone else’s) ears, we’d suspect. ED 
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Having no prior experience with 
audio equipment, Dane sought 
help online to eliminate humming 
noises from the speakers 


All of the components, 
including the Pi and the 
power bank, are neatly 
sealed within the case 


> It can play for up 
to six hours 

> It took around 20 
hours to build 

> The display frame 
was designed in 
Tinkercad 

> It was 3 D-printed on 
an Original Prusa i 3 

> The original 
boombox speakers 
were used 


▲ With Deezer installed on the microSD 
card, the Pi is wired to the stereo 
audio amplifier and connected to 
the display and speakers 


Dane added a startup 
script that opens the 
browser on the Deezer 
homepage in full-screen 
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Assembling the 
laser-cut hub and 
planetary gears, 
which are rotated by 
a stepper motor 

A Pi Zero runs the 
code, a Speaker 
pHAT provides chime 
sounds, while a 
Trinket Mo controls 
the NeoPixels 


w ■ 


Tide Clock 

Weather Thing 


Fin 

Hopkins 


A software engineer 
on the City of 
Boston's Digital 
Team, Fin is into 
board games, web 


This beautifully crafted device provides a detailed weather 
forecast and low tide times. Phil King is on cloud nine 


S eeking to make a gift for the in-laws looking 
after the kids in Maine over the summer, 

Fin Hopkins decided to build a 'Tide Clock 
Weather Thing’ to help predict the weather and 


colours for forecast weather conditions - including 
blue for rain, yellow for sunny, dim white for 
cloudy, and green for windy. Just above this strip, 
a moving bar with two pointers shows when the 


development, and 
socialjustice. 

magpi.cc/ZOSXTQ 


tides for days out at the beach or kayaking. 

a I remember [the reaction from the recipients] 
was something like 'wow, that’s beautiful! What 


two daily low tides will occur. 

A chime is also sounded for low and high tides 
using a Speaker pHAT connected to a Pi Zero, 


which runs the Python software and controls the 


□ I had to point out what all the lights 
and dials were, since there aren't 
any markings on the case □ 


NeoPixel LEDs via a Trinket Mo microcontroller. All 
the weather data is sourced from the Dark Sky API, 
while tide data comes from the NOAA’s Tides and 
Currents site. 

Time to make 



is it?’ I had to point out what all the lights and 
dials were, since there aren’t any markings on 
the case,” recalls Fin. 

How it works 

The large wheel on the device shows the current 
weather conditions on top; as they change, it 
rotates planetary gears to bring a new icon to the 
top. In the middle of the wheel, a finger points to 
the current temperature, with the forecasted daily 
range lit by coloured LEDs. Five more LEDs below 
light up blue for impending rain, filling up to show 
when it’s 60, 45, 30,15, or 5 minutes away. 

24 LEDs at the bottom of the device represent 
each hour of the day, lighting up in different 


From the first gear prototypes to a working version 
of the device took Fin about three weeks, working 
nights and weekends. "We were going to visit my 
in-laws for the 4 July holiday, so it was a sprint to 
a tight deadline at the end. I got all the hardware 
and wiring done, and then ended up finishing the 
coding while I was up there. ” 

The design adapted and fell into place as Fin 
prototyped, starting with the laser-cut planetary 
gears - for the weather symbols - which rotate 
around a central hub. "Once I saw how neat the 
large version [of the wheel] looked, it was 'OK, 
what else can I put with this?”’ 

A lot of the changes made concerned reducing 
the scope. "I wanted to show high and low tides 
over two days, with each indicator separately 
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SHOWCASE 


It's made from 
medium cherry and 
maple plywood 


The large wheel 
rotates 360° at the 
top of every hour 


A NeoPixel ring 
provides the 
LED arcs 


The laser-cut parts 
were designed 
in Inkscape 


Fin is working on an 
edge-lit acrylic sign 


The finger points to the current 


z) 1 

temperature, while lit LEDs show 


the daily range in 5 °F increments 




A micro-servo and gears move 
two pointers along to indicate 
times for the day’s low tides 




controlled. Once I got into c OK, now how would 
I build that?’ it became one day, then not 
separately controlled, then just low tides,” 
explains Fin. a Even after I simplified my goal for 
the tide indicator, it took a number of prototypes 
to get right.” 

Making their debut Raspberry Pi - and electronics 
- project was an educational process for Fin. “I 
learned how to solder, how to crimp wire, and I 
finally got my head around the difference between 
voltage and current. I learned about stepper motors, 
GPIO pins, PC communication, PWM, and a ton of 
other topics.” W 


A top-down view of the 
project, showing how aLL 
the Laser-cut and electronic 
parts fit together 
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rCrumbl 

Sometimes things don't always go to plan, but that's 
the way the cookie crumbles, David Crookes talks to 

about his attempt to create a 3G phone 

B ack in 1982, everyone's favourite extra¬ 
terrestrial, E.T., needed to phone home, so an 
attempt was made, via a coffee can filled with 
electronics connected to a tinfoil-lined umbrella, and 
a Speak & Spell. For many of today's modern makers, 
that would be an alien concept (not least because it 
just wouldn't work). But it's one Dylan Radcliffe may 
well have paid some thought to, given his struggles to 
create a 3G smartphone based around a Raspberry Pi. 

Usually our project showcases highlight the finished 
product, but in this case Dylan needs some help. 

When he began planning his project, he based it on 
the TyTelli DIY smartphone, a device made almost 
four years ago by Tyler Spadgenske that could snap 
photos, send texts, and make and receive calls. It used 
a specially written OS in Python and it was housed in 
a 3D-printed case. But it only worked on a 2G cellular 
network and Dylan found, to his horror, that his home 
country of Canada had finally phased it out. 

2G or not 2G 

“I’d purchased a PCB which was only designed to work 
with a 2G network, but I was lucky because the supplier 
had also released a 3G chip," he says. “Unfortunately, 
all of the software produced by others for their 
phones won’t work with this new chip, so this is my 

□ His primary aim of creating a Pi-based 
phone that could fit into his pocket has 
been a success □ 

challenge." So far, he's been able to call his landline 
using the command line, but he is vowing to do better 
and he hopes readers of The MagPi will be able to help. 

As it stands, Dylan has a functional pocket computer 
running Linux, but it remains a great example of 
determination. His primary aim of creating a Pi-based 
phone that could fit into his pocket has been a success, 
and that has been down to a great deal of time spent 
determining exactly how everything would need to be 
wired together in order to create a functional piece 
of electronics. 


Dylan Radcliffe 



Dylan Radcliffe 


As well as getting 
his hands dirty as a 
keen maker, Dylan 
Loves the great 
outdoors and he’s 
passionate about the 
environment, hiking, 
food, and gardening. 

1 magpi.cc/iTVuOC 




The build includes a Raspberry Pi B+ together with 
an Adafruit 3G GSM, an Adafruit Pi 3.5-inch TFT, 
and the Pi Camera Module V2.1. It also features an 
Adafruit PowerBoost 500 Basic charger, a 2500 mAh 
lithium-ion battery, a mini metal speaker, an 
Adafruit Electret microphone, and a rugged metal 
on-and-off switch. 


Wiring up 

Most of the connections on the breakout board are 
wired directly to the GPIO pins on the Raspberry 
Pi. “Charging the phone and most of the power 
requirements are handled by the Adafruit FONA 
modem, which has a built-in mini USB plug and 
provided GPS," Dylan reveals. “This does leave the 
phone at a disadvantage, though, because powering 
off the phone needs to be done via software before 
hitting the power button." 

To get everything to fit, Dylan spent a lot of 
time with a pair of callipers measuring distances 
between components and wires. “Once I had 
everything working, I created a small box on my 3D 
printer and tried to cram everything in, in a way 
that made sense," he says, knowing that he would 
end up soldering in the tightest environment he'd 
ever experienced. 

He then spent a couple hours thinking about how 
to optimise the design and writing notes before 
firing up his CAD software again. In the process, a 
small bracket was designed and used to attach some 
of the smaller PCBs to hold them in place. “All I 
have to do is get 3G working, but I’m sure I’ll get 
there in the end," discloses Dylan. M 1 
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Quick FACTS 


> rCrumbL is short for 
Raspberry Crumble 

> Dylan wants to run 
it on a 3G network 

> It makes calls via 
the command line 
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THE RASPBERRY PI 

SUPERGUIDE 




Everything you need to know to get started 
with Raspberry Pi - updated for 2019! 


W elcome to our ultimate guide for 

the Raspberry Pi! There’s always new 
Raspberry Pi software and hardware 
coming out and while we like to think we keep you 
updated on it all, it does mean that our complete 
guides can sometimes feel a little outdated. 

That’s why we’ve put together this: a completely 
new guide to getting started. If you are (or 
someone you know is) new to the Raspberry Pi, 
this guide has you covered. 

So, whether you have an original Model B or a 
brand-new 3A+, get ready to enter the world of 
Raspberry Pi. It’s a lot of fun! EH 


QUICKSTART 


GUIDE 


Get your Raspberry Pi working 


Got your Raspberry Pi but still not sure how 
to even get it turned on? It’s very simple - 
you just need to download an operating 
system from the Raspberry Pi website 
(magpi.cc/noobs), put it on a microSD 
card, and plug it in. 

Let us guide you through 
this process step-by-step in our 
QuickStart guide, which you can 
download here: magpi.cc/quickstart 
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OFFICIAL 


RESOURCES 


Want some more ideas of 
how to use your Raspberry 
Pi? Head online... 


RASPBERRY PI 
PROJECTS SITE 


rpf.io/projects 


Hundreds of projects from 
the Raspberry Pi Foundation, 
Code Club, and CoderDojo 
can be found here, covering 
a wide array of programming 
and electronics projects. A 
Lot of them are suitable for 
younger makers as well! 


DOCUMENTATION 


rpf.io/docs 


If you need some in-depth 
info about your Raspberry 
Pi and Raspbian, the 
official documentation is 
very thorough and even 
contains examples to 
help you understand what 
everything means. 


FORUMS 


rpf.io/forums 


The Raspberry Pi community 
can be found on the official 
forums, and they have plenty 
of expertise with using the Pi. 
You’Ll usually be able to find 
a solution to any issues you 
have here - and if not, you 
can always ask about it. 
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WELCOME TO THE 

RASPBERRY PI 
DESKTOP 


New to the world of Raspberry Pi? PJ Evans shows you around 


nee you’ve got Raspbian 
with Desktop and 
Recommended Software 
installed and running, you may be 
wondering what to do next. Let’s 
look at some of the key software 
installed, how to add more, and 
some of the differences between 
Raspbian and its peers, Windows 
and macOS. 


LIBREOFFICE 

Office suite 

Word processing, spreadsheets, 
presentations, databases, and 
drawing. A complete suite of office 
tools free with your Raspberry Pi. 
Compatible with other packages 
such as Microsoft Office. 




CHROMIUM 

Web browser 

An open-source version of Google 
Chrome, Chromium is a fast 
and fully-featured web browser 
that can handle the demands of 
modern websites. 


MagPi Rocks! 


TERMINAL 

Command-line access 

The gateway to thousands of 
powerful text-based applications 
and tools, you may find yourself 
using the Terminal a lot to run 
scripts or install software. 


SCRATCH 

Fun programming environments 

Scratch is the perfect introduction 
to coding. You can build games 
or even control Lights using the 
Pi’s GPIO pins. Its graphical block 
system makes coding friendly. 



MINECRAFT PI 

Open-world game 

Not only can you run Minecraft on a 
Pi, you can learn by interacting with 
its virtual world through code. The 
only limit is your imagination. 



Credit: Rob Zwetsloot 
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SONIC PI 

Music generation 

Known as 'Live coding’, creating 
music through code has been 
thrust into the mainstream by this 
phenomenal application. Your 
Raspberry Pi is now a serious 
musical instrument! 



VLC 

Media player 

The Swiss Army knife of media 
playback, supporting a multitude of 
video and audio formats. If it can be 
played, VLC will probably be able 
to play it. 



CLAWS MAIL 

Email client 

If you need more than webmail, 
Claws provides all the common 
features you’U need. It’s easy 
to configure and provides an 
elegant interface. 



INSTALLING 

SOFTWARE 



Open your 

package 

manager 


The most straightforward 
way to install software on 
Raspbian with Desktop is 
to use the ‘Add/Remove 
Software’ application. Start 
by clicking the Raspberry Pi 
logo to open the menu, then 
select 'Preferences’ followed 
by 'Add/Remove Software’. 


Get searching 

We’re going to install 
GIMP, so it’s as simple as 
entering 'gimp’ in the search 
box and pressing RETURN. 
After a few seconds, a list of 
matches appears. Click the 
one just labelled 'GNU Image 
Manipulation Program’. Any 
other required packages, 
known as dependencies, will 
automatically be installed. 


Install 

Now the good bit. 

Click 'Apply’. You will need 
to enter your password. 

Your application will 
then be downloaded and 
installed for you. Installation 
time will depend on your 
bandwidth and the size of 
the package in question. 
GIMP typically takes a couple 
of minutes to install. Once 
complete, you can find GIMP 
in the application menu 
under 'Graphics’. 



I Preferences 


Qj| A dd / Remove Software 
|j^ Appearance Settings 
iSi Audio Device Settings 
I Main Menu Editor 

Recommended Software 




f Accessories 
ISI Admin tools 
(SJ Communication 
GNOME desktop 
0 KDE desktop 
!B] Other desktops 
£ Fonts 
Games 
T Graphics 
© Internet 
y Legacy 
pH Localisation 
HI Multimedia 
JS Network 
Bother 
(D Programming 
D Publishing 
# System 

113 Science . 



gimp-cbmplugs-1 2 2-1 +b6 
gimp-data-2 8 18-1 rdeMul 
9 imp-data-extr * * A * 


CebjC 5 ng syr installing packages - please wan 
9imp.dbg.2 8- Loaftngccfe 

gimp-dcrawl 


gimp-dds-30 


Cancel 



GIMP is an advanced picture editor You can use it to edit, enhance, and 
retouch photos and scans, create drawings, and make your own images 
It has a large collection of professional-level editing tools and filters, 
similar to the ones you might find in Photoshop Numerous fine-control 
settings and features like layers, paths, masks, and scnptmg give you 


| *| Download sue 39 MB 
Licence unknown 
Sot'ce raspbian-stable-main 
, Cancel Apply OK 
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CODE HELLO WORLD 


Start Thonny 

The Raspberry Pi is designed to make 
it easy to learn to program a computer. 
There are lots of 
programming 
languages, but the 
best one to start with 
is Python. You can use 
Python on a Raspberry 
Pi using a program 
called Thonny. From 
the application menu, 
select Programming > 

Thonny Python IDE. 


li 

(g Education 
^ Office 
0 Internet 
f*f Sound & Video 
Y Graphics 

M Gam « 

©Hdp 


BiueJ Java IDE 

> $§) Geany Programmer's Etftor 

> ^ Greenfoot Java lOE 
» Mathematics 

> 9 '.xle-REO 

> l*J Python 3 (iDLD 
» Scratch 

> e Scratch 2 

> Sense HAT Emulator 



Hello World 

It’s traditional 
for any new program in 
a language to display 
Hello World on the 
screen. Click on the 
main screen in Thonny 
and enter: 



print("Hello World") 


Click Save and call your program hello_world.py. 


Run your code 

Click on the green Run button. 
Congratulations! You’ve just run your first computer 
program. Python is a very easy language to learn. 
Visit magpi.cc/learnpython to read our starter guide. 



SWITCH TO 

aspbian is the name for 
the Raspberry Pi’s official 
operating system and it’s a 
Linux distribution. ‘Raspbian with 
Desktop’ comes with a graphical 
user interface. Here are some key 
differences between the Desktop 
and other systems. 



APPLICATION MENU 

The application launch menu 
operates in a similar way to Windows, 
but is located at the top. Clicking the 
Raspberry Pi logo (top left) displays 
the menus where you can find pre¬ 
installed software and access to 
various utilities. Favourite apps can be 
pinned on the left and some utilities 
can be controlled on the right. 



TERMINAL CONFUSION 

Chances are, you’ll use the Terminal a 
lot to run scripts and issue commands 
to the operating system. This 
command-line interface is common 
to all operating systems, but often 
goes by different names. 'Command 
Prompt' (Windows), ‘Console’, and 
‘Terminal’ all refer to the same thing. 
Learn more at magpi.ee/terminal 

DIRECTORY LAYOUT 

All users on Raspbian have a 
home directory in /home. Just like 
Windows and macOS, you’ll see 
directories such as ‘Music’ and 
‘Pictures’ already created for you. 

FILE MANAGER 

Like other operating systems, you can 
graphically browse the file system. 


RASPBIAN 

Your default user is ‘pi’ and your 
home directory is /home/pi. Don’t 
worry about looking around but if 
you’re asked for a password before 
changing a file, the system might be 
trying to protect it, so take care. 

REMOTE CONTROL 

Want to get remote control of your 
Pi? Windows has ‘Remote Desktop’, 
macOS has ‘Back to my Mac’, and 
Raspbian has VNC. A server is 
installed by default but not active. 
Enable it in Preferences > Raspberry 
Pi Configuration > Interfaces. 

SSH 

If you just need remote command-line 
access to your Pi, SSH can be enabled 
to provide a ‘Secure Shell’. This can be 
accessed from other Pi boards, Linux 
distributions or macOS using Terminal, 
or the PuTTY app for Windows. 

WASTEBASKET 

While macOS has ‘Trash’ and 
Windows has a ‘Recycle Bin’, the 
Raspberry Pi has the ‘Wastebasket’. 

It works in exactly the same way. 

t ti «>) ra 17:35 - 

WHAT'S WITH 
THE PERCENTAGES? 

If you’re scratching your head over 
the bar graph placed in the top- 
right, it’s a live reading of the CPU’s 
activity. If things appear slow and 
the percentage is high, it may be 
the machine is ‘having a think’ or too 
many tasks are running. 

ACCESSORIES 

The Accessories menu provides 
applications for many common tasks. 
Both Image Viewer (in the Graphics 
menu) and PDF Viewer have the 
functionality of macOS’s Preview. 
There’s also a Task Manager which, 
Like Windows (or Activity Monitor in 
macOS), allows you to track what’s 
going on with your machine. 
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RASPBERRY PI AND THE 

PHYSICAL 
WORLD 


Take your coding further 
and break out of the 
screen into the real world 


T he one piece of hardware that separates 
the Raspberry Pi from the average 
desktop PC or laptop is its GPIO 
(general-purpose input/output) header. 

This collection of pins on the edge of the 


board provides a simple, safe way to connect 
circuits to the Pi so it can interact with 
its surroundings. From blinking a light to 
controlling a home security system, it’s the 
GPIO that makes it all possible. 


ELECTRONICS COMPONENTS AND KIT 


BREADBOARD 
^ magpi.cc/tswjyk 

An easy way to connect components together 
and to the Pi itself. Cheap, easy to use, and 
essential for prototyping your next masterwork. 



JUMPER WIRES 


^ magpi.cc/ecmNPS 

Jumper wires are used to make connections on 
the breadboard and to the Raspberry Pi's GPIO 
pins. Look out for multipacks containing different 
Lengths and types. 



LEDS 

^ magpi.cc/gqdVMP 

Add some colour to your project with Light- 
emitting diodes. Inexpensive and a fun 
component for your first projects. Available 
in multiple colours. 



TACTILE BUTTONS 
^ magpi.cc/aCtkRt 

The GPIO handles input as well as output, so a 
great way to Learn is with a tactile button. These 
fit straight on to breadboards for easy building. 




BUZZERS 
^ magpi.cc/ijcKzz 

Make some noise! Simple buzzers come in 
a wide variety of types and sizes, and are 
straightforward to add to projects. 


RELAYS 

^ magpi.cc/nRidMi 

Want to switch something on but not be 
connected directly to its circuit? Relays are 
a simple solution where you don’t ‘cross 
the streams’. 


STRIPBOARD 

^ magpi.cc/mirhkq 

A cheap alternative to custom PCBs 
for small circuits. Strips (or pads) of 
copper on a board on to which you can 
solder components. 


SOLDERING IRON 

^ magpi.cc/gnxPQs 

If you want to transfer a breadboarded circuit 
to a PCB or stripboard, you’ll need a soldering 
iron, a stand, and some lead-free solder. 
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LIGHTING 
AN LED 


Wire to the Pi 

Orientate the Pi so the 
Ethernet and USB ports are at the 
bottom (six o’clock). Now pin l 
of the GPIO is the top pin on the 
left. GPIO 17 is the sixth pin down 
on the left. Connect a jumper 
cable to this pin and then to the 
positive leg of the LED (via a hole 
in the same breadboard column). 


W hen you first learn 
to code, chances are 
you’ll write a program 
to display ‘Hello, World!’ on 
the screen. 

When learning electronics, 
you’ll make something light up. 
No exceptions here! Let’s see 
how, with just a few lines of code, 
the GPIO can light up your life. 


Our Light must be the 
right way round to 
work. The Longer Leg 
indicates positive 



Insert the LED into 
the breadboard 


As one of the LED’s legs is 
longer than the other, you may 


The resistor 'squeezes’ the 
current to make it safe for 
the Pi and LED aLike 



need to bend it (carefully!) so 
both legs will fit securely in 
the breadboard. LEDs will only 
work one way round in a circuit, 
so the longer leg indicates the 
positive side. 


Add a resistor 

An LED will attempt 
to draw more current than 
a Raspberry Pi can handle, 
potentially damaging the LED or 
even the Pi. To prevent this, we 
must add a resistor which will 
limit the flow of electricity to 
safe levels. Place a 330 Q resistor 
so it connects with the negative 
(shorter) leg of the LED. 


Grounding 

Finally, for the current to 
flow, it needs a ground. Connect 
another jumper cable to one of 
the GND pins of the GPIO. There’s 
one directly above GPIO 17. This 
connects to the other side of the 
resistor (again, via a breadboard 
hole in the same column). 


Code 

We’ll use Python with the 
GPIO Zero library to control the 
LED. Under ‘Programming’ in 
the main menu, open ‘Thonny 
Python IDE’ and enter the 
code below exactly as shown, 
including the indentations. Then 
click ‘Run’ to see the LED blink. 


Example Code 


# Extend Python's capabilities 
from gpiozeno import LED 
from time import sleep 



# Set 'red' to represent the LED 
red = LED(17) 

# Loop forever 
while True: 

# Send current to the LED for one second 
red.onQ 

sleep(l) 

# Stop the current for one second 
red. off () 

sleep(l) 
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FEATURE I 


USING A 


L et’s add some input to 
our new circuit. We’ll add 
a push-button that can 
control the LED. 



BUTTON 


The pins opposite each other 
are always connected, so the 
protruding sides needs to ‘bridge’ 
the lines of the breadboard. 


01 

Orientate 
the button 

02 

Connect to the GPIO 

We need to connect 

03 


Start by placing your push¬ 
button in the breadboard, being 
careful not to interfere with the 
LED circuit. The button has four 
pins which protrude on two sides. 


the button to the GPIO so we 
can monitor its state. We’ll 
use GPIO18 for this, which is 
the pin directly to the right of 
GPIO 17, the one we used in the 


» 


Be careful which way round you place 
the push-button. There should only 
be one 'space' between the legs on 
the breadboard 


• • • • • 

• Jll i F = 


We're using different 
GPIO pins, so the two 
circuits are isolated 


LED circuit. Now connect the 
other end of the jumper cable 
to either of the button’s legs 
on the breadboard. 


Ground the button 

Just like the LED, we 
need to ground the button so 
current will flow. There is a 
spare ground point directly 
below GPIO 18. Connect this to 
the other leg on the short side 
of the button. Before switching 
anything on, check and check 
again that the GPIO is wired 
up correctly. 


More code 

Just like before, enter the 
code below into Thonny and click 
‘Run’. Now, when the button is 
pressed, the LED will light up. 
What else can you make it do? 


MatfPi 

.■SIMPLE ¥" 

\ ELECTRONICS 

\gpioZERO 





MAGPI 

ESSENTIALS 

SIMPLE 
ELECTRONICS 
WITH GPIO ZERO 
Get up-and-running 
with electronics 
quickly with our GPIO 
Zero Essentials Guide, 
magpi.cc/gpio-zero 


Example Code 



# Extend Python's capabilities 

from gpiozero import LED., Button 
from signal import pause 

# Assign these variables to our LED and button 
led = LED(17 ) 

button = Button(18) 

# Assign events that are triggered when the button is used 

button.when_pressed = led.on 
button.when_released = led.off 

# This command prevents Python from exiting 
pauseQ 
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COMMAND-LINE 

SUPER BASICS 


The command line is a powerful 
and efficient way to interact with 
your Raspberry Pi 


T he Terminal application 
is your gateway to the 
Raspbian command line. 
Yes, having a black screen with 
a flashing cursor and little else 
may seem a little intimidating, 
but with practice the command 
line becomes a go-to 
environment for getting things 
done. Click the Terminal icon in 
the Task Bar to start.. 


pi(3)raspberrypi: ~ _ □ x 


File Edit Tabs Help 


|pi@raspberrypi: - $ | 


COMMANDS 


| Mtufpl 


CONQUER 

^COMMAND 


I LINE 



MAGPI 

ESSENTIALS 

CONQUER THE 
COMMAND LINE 
Master your computer 
using command-line 
code in Terminal with 
our free guide. 
magpi.cc/ 
essentials-bash 


sudo 

‘Super/substitute user do 5 . 

Some commands require extra 
privileges to work. Prefixing the 
command with ‘sudo 5 allows 
this. If you forget, type sudo !! 
to repeat the previous command. 


sudo raspi-config 


apt 

APT is Raspbian 5 s package 
manager. It can be used to install 
a huge range of applications and 
also keeps existing installations 
up to date. 


sudo apt install gimp 


cd directory path 

Raspbian stores files in 
directories. ‘cd 5 is short 


for ‘change directory 5 , so 
cd /boot will take you to the 
Pi 5 s boot directory, cd on its 
own always takes you to your 
home directory. 


cd /home/pi/MagPi 


Is directory 

View the contents of a directory 
(list). If you omit the directory, 
the current one will be listed. 
Add -1 before the directory for 
a more detailed output. 


Is -1 /boot 


cpj mv, and rm 

‘Copy, move, and remove 5 . These 
are used to make copies of files 
or directories, move files around, 
rename or delete them, cp 


takes two arguments: source 
and destination. 


cp /home/pi/MagPi/MagPi75 
pdf /home/pi/Desktop/ 
MagPi75.pdf 


mkdir and rmdir 

Make and remove directories. 
You can have as many as you 
like, and have directories 
within directories. 

Tip: To create multiple levels 
in one command, use -p. 


mkdir -p /home/pi/my/new/ 
directory/tree 


exit 

When you’re done in the 
Terminal, simple type exit to 
cleanly close everything down. 
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JARGON BUSTER 


Worried about your boot? Pip got you pipped? Here are some of 
the more common terms you'll hear in the Raspberry Pi universe 


APT 

Advanced Package Tool. This 
is the Raspbian package 
manager for installing and 
upgrading applications. 

ARM 

Designer of the Raspberry Pi’s 
processor architecture. 

Broadcom 

Manufacturer of the Raspberry Pi’s 
main processor. 

Burn 

The process of writing an operating 
system image to an SD card. 

Distribution 

The many versions of Linux, 
including Raspbian, are known 
as Linux distributions. 

DSI 

Digital Serial Interface. The DSI 
connector on the Raspberry Pi can 
be used to connect displays. 

Ethernet 

A wired networking system. 

GPIO 

General-purpose input/output. 

An array of pins for connecting 
physical circuits to the Pi. 

GPIO Zero 


A Python library of tools for 
communicating via the GPIO. 


GPU 

Graphics processing unit. On the 

Pi, this assists the main processor 
to provide smooth, fast graphics. 

HDMI 

All Raspberry Pi models provide an 
HDMI output to connect to modern 
televisions and monitors. 

I 2 C 

Inter-Integrated Circuit. Like 

SPI, allows multiple devices to be 
connected to the Pi via the GPIO. 

Kernel 

A small piece of code that is the heart 
of the operating system. Everything 
runs 'on top’ of the kernel. 

Linux 

A family of open-source operating 
systems, including Raspbian. 

os 

Operating system - the code that 
handles the interaction between 
the processor, its devices, and the 
outside world. 

Packages 

Distributions of applications that 
are handled by APT. 

pip 


A package manager for Python to 
ease the installation of Python 
libraries and other applications. 


Prompt 

As in 'prompt for input’. The 
$ symbol before your cursor in 
the Terminal. 

Raspbian 

The official operating system of the 
Raspberry Pi. 

SoC 

'System on a Chip’. The main 
processor on the Raspberry Pi 
handles many functions of a 
computer in a single package. 

SPI 

Serial Peripheral Interface. Away 
for devices to communicate. The 
GPIO features an SPI interface. 

SSH 

'Secure Shell’. A way of accessing 
a command-line interface on a 
remote computer. 

sudo 

'Super/substitute user do’. Run 
a command with the highest- 
possible privileges. 

Terminal 

A program that gives access to the 
Raspbian command-line interface. 

UART 


Universal asynchronous receiver- 
transmitter’ . A very simple way for 
computers to communicate. 
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EASY HOME 

PROJECTS 



Build something small and useful with your Raspberry Pi 


MAGPI ISSUE 66 

Discover a range of easy-to- 
build media player projects in 
The MagPi #66: magpi.cc/66 


A fter setting up your Raspberry Pi and learning about 
all its features, the first thing you’ll want to do is 
to build something useful. Nothing helps you learn 
like a project, and the Raspberry Pi can become all kinds 
of different things. We’ve picked three simple and fun 
projects to help you get started. 

HOME THEATRE PC 





YOU'LL NEED 

► Raspberry Pi 
(any model) 

► LibreELEC 

(libreelec.tv) 

► HDMI cable 

► Power supply 

(magpi.cc/power) 

► Remote control 

(magpi.cc/cxudSB) 


Install LibreELEC 

Kodi is our favourite 
media centre software. With Kodi 
you can play your own movie and 
music files. Kodi is available on 
the Raspberry Pi in a range of 
different operating systems. The 
best in our eyes is LibreELEC, 
available in NOOBS (New Out 
Of Box Software). Follow our 
Raspberry Pi QuickStart guide 
(magpi.cc/quickstart), but 
choose LibreELEC instead of 
Raspbian in Step 5. 


Set up Kodi 

LibreELEC will boot up 
into the Kodi interface. For 
the setup process, it is useful 
to plug a keyboard into your 
Raspberry Pi (although you 
can use Kodi just fine with a 
remote control). Go through the 
Welcome process and connect to 
your local wireless LAN network 
(or use an Ethernet cable). 
Samba remote access should be 
activated by default; ensure it’s 
set to on. Use SSH and take note 
of the IP address if you’re using 
a Mac. 


Copy movies 
across 

With Samba enabled, you can 
copy video files from a Windows 
PC to your Raspberry Pi pretty 
easily. Open a File Explorer 
window in Windows, and click 
on Network in the Navigation 
pane; double-click LIBREELEC. 
Drag and drop movie files to the 
Videos folder (and likewise for 
Music, TV Shows, and Pictures). 
Use Kodi to select the video and 
start playing it. 
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RETRO CONSOLE 


RetroPie 

Turning a Raspberry Pi 
into a retro games console is 
another easy (and fun) project. 
It's incredibly easy and good 
value too. You can set it up 
with a keyboard, but attach 
a game controller for a low- 
cost retro games console. Use 
NOOBS to set up a Raspberry 
Pi and make sure you have an 
internet connection (click ( Wifi 
networks’ to join your network 
during installation). This 
enables you to access a wider 
range of operating systems, 
including Lakka_RPi 2 . 



Connect to network 

Connect Lakka to your 
network. Using your gamepad 
(or a keyboard), navigate to 
Settings > WiFi and connect 
to your wireless LAN. Now 
navigate to Settings > Services 
and set SAMBA Enable to On. 




Transfer ROM 

Games are supplied 
separately as ROM files, and 
you must find your own. There 
are many homebrew games 
(modern games developed for 
classic consoles) and one of 
our favourites is Blade Buster, 
developed for NES hardware. 
You can get Blade Buster 
from the developer’s website 
(magpi.cc/bladebuster - it’s in 
Japanese, but click Download). 
The ROM is a zip file (do not 
unzip it). Copy the zip file into 
Network > Lakka > ROMs. 


M Get a wireless USB controller like this 
one from The PiHut magpi.cc/gamepad 


Playing games 

Now go Load Content 
> Start Directory and you 
should see the zip file you 
transferred at the bottom 
(ours is BB_20120301.zip). 
Select the file and choose Load 
Archive and NES / Famicom 
(FCEUmm). The game should 
load. Enjoy shooting the 
baddies in this modern classic 
vertical shoot-’em-up. 



MAGPI ISSUE 67 

Discover a wealth of retro 
goodness in The MagPi #67. 

magpi.cc/67 
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Mark 

Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 

magpi.cc/YiZnxl 

@mindexplorers 


You'll Need 

> Raspbian Jessie 
or newer 

> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/nBSXKz 

> The latest version 
of Pygame Zero 
(1.2) 

> USB joystick or 
gamepad (optional) 


Code your own 

Pac-Man game 

Pac-Man captured the hearts and pocket money of many young 
people in the eighties. Since then, it has made its way onto just 
about every computer system and console 


T he concept of Pac-Man is quite simple. 

Pac-Man eats dots in a maze to score points. 
Avoid the ghosts unless you have just eaten 
a power-up, in which case ghosts are tasty. In this 
series we have gradually introduced new elements 
of Pygame Zero and also concepts around writing 
games. This is the first instalment in a two-part 
tutorial which will show you some more tricks 
to writing arcade games with Pygame Zero. We 
will also use some more advanced programming 
concepts to make our games even better. In this 
first part, we will put together the basics of the 
Pac-Man game and introduce the concept of adding 
extra Python modules to our program. 


Let's get stuck in 

As with the more recent episodes of this 
series, let’s jump straight in, assuming that 
we have our basic Pygame Zero setup done. 

Let’s set our window size to WIDTH = 600 and 
HEIGHT = 660. This will give us room for a roughly 
square maze and a header area for some game 
information. We can get our gameplay area set up 
straight away by blitting two graphics - ‘header’ 
and ‘colourmap’ - to 0,0 and 0,80 respectively in 
the draw() function. You can make these graphics 
yourself or you can use ours, which can be found 
at magpi.cc/nBSXKz. 


It's amazing 

The original game had a very specific 
layout to the maze, but many different ones have 
appeared in later versions. The one we will be using 
is very similar to the original, but you can make 



▲ Because Pac-Man didn't involve shooting things, 

the Japanese designers thought it would appeal more to girls 


your own design if you want. If you make your own, 
you’ll also have to make two more maps (we’ll 
come to those in a bit) which help with the running 
of the game. The main things about the map is that 
it has a central area where the ghosts start from 
and it doesn’t have any other closed-in areas that 
the ghosts are likely to get trapped in (they can be 
a bit stupid sometimes). 


Hmmm, pizza 

Our next challenge is to get a player actor 
moving around the maze. For some unknown 
reason, the game’s creator, Torn Iwatani, decided 
to make the main character a pizza that ate dots. 
Well, the eighties were a bit strange and that 
seemed perfectly reasonable at the time. We’ll 
need two frames for our character: one with the 
mouth open and one with it closed. We can create 
our player actor near the top of the code using 
player = Actor ("pacman_o" ). This will create the 
actor with the mouth-open graphic. We will then 
set the actor’s location in an init( ) function, as in 
previous programs. 
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Modulify to simplify 

We can get our player onto the play area by 
setting player .x = 290 and player .y = 570 in 
the init() function and then call player. draw() 
in the draw( ) function, but to move the player 
character we’ll need to get some input from the 
player. Previously we have used keyboard and 
mouse input, but this time we are going to have the 
option of joystick or gamepad input. Pygame Zero 
doesn’t currently directly support gamepads, but 
we are going to borrow a bit of the Pygame module 
to get this working. We are also going to make a 
separate Python module for our input. 


It's a joystick.init 

Setting up a new module is easy. All we need 
to do is make a new file, in this case gameinput.py, 
and in our main program at the top, write import 
gameinput. In this new file we can import the 
Pygame functions we need with from pygame 
import joystick, key and from pygame.locals 
import *. We can then initialise the Pygame 
joystick object (this also includes gamepads) by 
typing joystick. init (). We can find out how 
many joysticks or gamepads are connected by using 
joystick_count = joystick.get_count(). If we 
find any joysticks connected, we need to initialise 
them individually - see figurei.py. 



The maze is made of 
corridors and maze walls 


Ghosts move around the 
maze, looking for Pac-Man 


The player is represented 
by the Pac-Man character 
that moves around the 
maze, eating dots 


Checking the input 

We can now write a function in our 
gameinput module to check input from 
the player. If we define the function with 
def checklnput(p) : we can get the x axis of a 
joystick using joyin .get_axis(0) and they axis 
by using joyin. get_axis(l). The numbers that 
are returned from these calls will be between -l 
and +1, with o being the central position. We can 
check to see if the values are over o .8 or under 
- 0 . 8 , as, depending on the device, we may not 
actually see -l or l being returned. You may like to 
test this with your gamepad or joystick to see what 
range of values are returned. 


Up, down, left, or right 

The variable p that we are passing into our 
checklnputQ function will be the player actor. We 


figurei.py 


001. # gameinput Module 
002 . 

003. from pygame import joystick, key 
004. from pygame.locals import * 

005. 

006. joystick. init () 

007. joystick_count = joystick. get_count( ) 
008. 

009. if (joystick_count > 0): 

010. joyin = joystick. loystick(0) 

011. joyin. init() 

012. # For the purposes of this tutorial 

013. # we are only going to use the first 

014. # joystick that is connected. 


Top Tip 4 

Modules 


Using separate 
modules means 
not only is your 
code easier 
to follow, but 
it’s easier for 
a team to 
work on. 
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figure2.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 


def checklnput(p) : 

global joyin, joystick_count 
xaxis = yaxis = 0 
if joystick_count > 0: 

xaxis = joyin.get_axis(0) 
yaxis = joyin .get_axis(l) 
if key .get_pnessed( )[K_LEFT] on xaxis < -0.8: 
p.angle = 180 
p.movex = -20 

if key.get_pressed( )[K_RIGHT] on xaxis > 0.8: 
p.angle = 0 
p.movex = 20 

if key.get_pnessed( )[K_UP] on yaxis < -0.8: 
p.angle = 90 
p.movey = -20 

if key.get_pnessed( )[K_DOWN] on yaxis > 0.8: 
p.angle = 270 
p.movey = 20 


figure3.py 

001. 

# inside updateQ function 

002. 


003. 

if player.movex or player.movey: 

004. 

inputLocl<( ) 

005. 

animate(player, pos=(player .x + player. 


movex, player.y + player.movey), duration=l/SPEED, 
tween= 1 linear' , on_f inished=inputllnl_ock) 

006. 


007. 

# outside updateQ function 

008. 


009. 

def inputLockQ: 

010. 

global player 

011. 

player.inputActive = False 

012. 


013. 

def inputl)nLock( ): 

014. 

global player 

015. 

player.movex = player.movey = 0 

016. 

player.inputActive = True 



▲ You can plug a gamepad or joystick into one of the USB ports 
on your Raspberry Pi 


Get a move on! 

Now we have our input function set up, we 
can call it from the update() function. Because this 
function is in a different module, we need to prefix 
it with the module name. In the update() function 
we write gameinput .checklnput(playen). After 
this function has been called, if there has been any 
input, we should have some variables set in the 
player actor that we can use to move. We can say 
if player.movex or player.movey: and then use 
the animate () function to move by the amount 
specified in player. movex and player. movey. 


Hold your horses 

The way we have the code at the moment 
means that any time there is some input, we fire 
off a new animation. This will soon mean that 
layers of animation get called over the top of each 
other, but what we want is for the animation to run 
and then start looking for new input. To do this we 
need an input locking system. We can call an input 
lock function before the move and then wait for 
the animation to finish before unlocking to look for 
more input. Look at figure3.py to see how we can 
make this locking system. 


can test each of the directions of the joystick at the 
same time as the keyboard and then set the player 
angle (so that it points in the correct direction for 
movement) and also how much it needs to move. 
We’ll set these by saying (for example, if the left 
arrow is pressed or the joystick is moved to the 
left)if key.get_pressed()[K_LEFT] on xaxis < 
-0.8: and then p.angle = 180 and p.movex = -20 
See figure2.py for the full checklnput () function. 


You can't just move anywhere 

Now, here comes the interesting bit. We 
want our player actor to move around the maze, but 
at the moment it will go though the walls and even 
off the screen. We need to restrict the movement 
only to the corridors of the maze. There are several 
different ways we could do this, but for this game 
we’re going to have an image map marking the 
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areas that the player actor can move within. The 
map will be a black and white one, showing just the 
corridors as black and the walls as white. We will 
then look at the map in the direction we want to 
move and see if it is black; if it is, we can move. 


Testing the map 

To be able to test the colour of a part of an 
image, we need to borrow a few functions from 
Pygame again. We 5 11 also put our map functions 
in a separate module. So make a new Python file 
and call it gamemaps.py and in it we’ll write 
from pygame import image. Color. 

We must also load in our movement map, which 
we need to do in the Pygame way: moveimage = 
image.load('images/pacmanmovemap.png '). Then 
all we need to do is write a function to check that 
the direction of the player is valid. See figure 4 .py 
for this function. 


Using the movemap 

To use this new module, we need to 
import gamemaps at the top of our main code 
file and then, before we animate the player (but 
after we have checked for input), we can call 
gamemaps. checkMovePoint(player), which will 
zero the movex and movey variables of the player 
if the move is not possible. So now we should find 
that the player actor can only move inside the 
corridors. We do have one special case that you 
may have noticed in figure 4 .py, and that is because 
there is one corridor where the player can move 
from one side of the screen to the other. 


You spin me round 

There is one more aspect to the movement 
of the player actor, and that is the animation. 

As Pac-Man moves, the mouth opens and shuts 
and points in the direction of the movement. 

The mouth opening and closing is easy enough: 
we have an image for open and one for closed 
and alternate between the two. For pointing in 
the correct direction, we can rotate the player 
actor. Unfortunately, this has a slight problem 
that Pac-Man will be upside-down when moving 
left. So we just need to have one version that is 
switched the other way round. See figures.py 
for a function that sorts out all of this. 


figure4.py 


001. # gamemaps module 

002. from pygame import image. Color 

003. moveimage = image.load(' images/pacmanmovemap.png' ) 

004. 

005. def checkMovePoint(p) : 

006. global moveimage 

007. if p.x+p.movex < 0: p.x = p.x+600 

008. if p.x+p.movex > 600: p.x = p.x-600 

009. if moveimage. get_at ( (int (p.x+p.movex), int(p.y+p. 

movey-80))) != Color( 'black' ): 

010. p.movex = p.movey = 0 


figure5.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 


def getPlayerImage( ): 
global player 

# we need to import datetime at the top of our code 
dt = datetime. now() 

a = player.angle 

# this next line will give us a number between 

# 0 and 5 depending on the time and SPEED 

tc = dt.microsecond%( 500000/SPEED)/(100000/SPEED) 
if tc > 2.5 and (player.movex != 0 or player.movey 
! = 0 ) : 

# this is for the closed mouth images 
if a != 180: 

player.image = "pacman_c" 
else: 

# reverse image if facing left 
player.image = "pacman_cr" 

else: 

# this is for the open mouth images 
if a != 180: 

player.image = "pacman_o" 
else: 

player.image = "pacman_or" 

# set the angle on the player actor 
player.angle = a 


Top Tip A 


Pygame 


Pygame Zero is based on Pygame, but if you want 
to use some of the Pygame functions, best to do it 
in a separate module to avoid confusion. 


Pygame Zero Pac-Man 
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figure6.py 


001 . 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 

028. 

029. 

030. 

031. 

032. 

033. 

034. 

035. 

036. 

037. 


# This goes in the main code file. 

def initDotsQ: 

global pacDots 
pacDots = [] 
a = x = 0 
while x < 30: 
y = 0 

while y < 29: 

if gamemaps. checkDotPoint(10+x*20, 10+y*20): 
pacDots. append (Acton ("dot", (10+x*20, 

90+y*20) )) 

pacDots[a].status = 0 
a += 1 
y += 1 
x += 1 

# This goes in the gamemaps module file. 

dotimage = image. load ( 'images/pacmandotmap.png' ) 

def checkDotPoint(x,y) : 
global dotimage 

if dotimage. get_at((int(x), int(y))) == 

Colon( black ): 

return True 
return False 

# This bit goes in the drawQ function. 

pacDotsLeft = 0 
for a in range(len(pacDots) ): 
if pacDots[a].status == 0: 
pacDots[a]. drawQ 
pacDotsLeft += 1 

if pacDots[a] .collidepoint((player.x, player.y)): 
pacDots[a].status = 1 

# if there are no dots left, the player has won 
if pacDotsLeft == 0: player.status = 2 


Spot on 

So when we have put in a call to 
get Player Image () just before we draw the player 
actor, we should have Pac-Man moving around, 
chomping and pointing in the correct direction. 
Now we need something to chomp. We are going 
to create a set of dots at even spacings along most 
of the corridors. An easy way to do this is to use 
a similar technique that we’re using for testing 
where the corridors are. If we make an image map 
of the places the dots need to go and loop over the 


whole map, only placing dots where it is black, we 
can get the desired effect. 


Tasty, tasty dots 

To get our dots doing their thing, we’ll need 
to code a few things. We need to initialise actors 
for each dot, we need to draw each dot, and if the 
player eats the dot, we need to stop drawing it; 
figure 6 .py shows how we can do each of these 
jobs. We need initDotsQ, we need to add another 
function to gamemaps.py to work out where 
to position the dots, and we need to add some 
drawing code to the draw( ) function. In addition 
to the code in figure 6 .py, we need to add a call to 
initDotsQ in ourinitQ function. 


I ain’t afraid of no ghosts 

Now that we have our Pac-Man happily 
munching dots, we must introduce our villains 
to the mix. In the original game, the ghosts had 
names; in the English version they were known as 
Blinky, Pinky, Inky, and Clyde. They roam the maze 
looking for Pac-Man, starting from an enclosure in 
the centre of the map. We can initialise each ghost 
as an actor to appear at the centre of the maze and 
keep them in a list called ghosts [ ]. To start off 
with, we’ll just make them move around randomly. 
The way we can do this is to set a random direction 
(ghosts [g]. dir) for each and then keep them 
moving until they hit a wall. 
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Random motion 

We can use the same system that we used to 
check player movement for the ghosts. Each time 
we move a ghost - moveGhosts () - we can get a list 
of which directions are available to it. If the current 
direction (ghosts [g]. dir) is not available, then we 
randomly pick another direction until we find one 
that we can move in. We can also have a random 
occurrence of changing direction, just to make it a 
bit less predictable - and if the ghosts collide with 
each other, we could do the same. When we have 
moved the ghosts with the animate () function, 
we get it to count how many ghosts have finished 
moving. When they are all done, we can call the 
moveGhosts Q function again. 
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TopTip 4 


Animations 


When using the animate() function, it is best to use 
the callback function to see when it has finished, as 
different systems may work at different speeds. 


Look like a ghost 

The last thing to do with our ghosts is to 
actually draw them to the screen. We can create 
a function called d nawGhosts () where we loop 
through the four ghosts and draw them to the 
screen. One of the details of the original game 
was that the eyes of the ghosts would follow the 
player; we can do this by setting the ghost image 
to reverse if the player is to the left of the ghost. 
We have numbered images so that ghost one is 
ghosti.png and ghost two is ghost 2 .png ) etc. Have 
a look at the full pacmani.py program listing to 
see all the functions that make the ghosts work. 


Game over 

Of course, we need to deal with the end-of- 
the-game conditions and, as before, we can use 
a status variable. In this case we have previously 
set player, status = 2 if the player wins. We 
can check to see if a ghost collides with the player 
and set player. status = 1 . Then we just need to 
display some text in the draw( ) function based on 
this variable. And that's it for part one. In the next 
part we'll be giving the ghosts more brains, adding 
levels, lives, and power-ups - and adding some 
sweet, soothing music and sound effects. EH 
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[gameinpuLpy 

> Language: Python 3 

001. 

# gameinput Module 

002. 


003. 

from pygame import joystick, key 

004. 

from pygame.locals import * 

005. 


006. 

joystick. init() 

007. 

joystick_count = joystick. get_count() 

008. 


009. 

if(joystick_count > 0): 

010. 

joyin = joystick. loystick(0) 

011. 

joyin.initQ 

012. 


013. 

def checklnput(p) : 

014. 

global joyin, joystick_count 

015. 

xaxis = yaxis = 0 

016. 

if joystick_count > 0: 

017. 

xaxis = joyin. get_axis(0) 

018. 

yaxis = joyin. get_axis(l) 

019. 

if key.get_pressed()[K_LEFT] or xaxis < -0.8: 

020. 

p.angle = 180 

021. 

p.movex = -20 

022. 

if key .get_pressed() [K_RIGHT] or xaxis > 0.8: 

023. 

p.angle = 0 

024. 

p.movex = 20 

025. 

if key.get_pressed() [ K_UP] or yaxis < -0.8: 

026. 

p.angle = 90 

027. 

p.movey = -20 

028. 

if key.get_pressed() [K_DOWN] or yaxis > 0.8: 

029. 

p.angle = 270 

030. 

p.movey = 20 


▼ Three maps are used: one 
which we see, one to check 
possibLe movements, and 
one to check where dots 
are to be placed 
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gamGmaps.py 


> Language: Python 3 


001. # gamemaps module 
002. 

003. from pygame import image. Color 
004. moveimage = image. load (' images/ 
pacmanmovemap.png' ) 

005. dotimage = image. load (' images/ 
pacmandotmap.png' ) 

006. 

007. def checkMovePoint(p) : 

008. global moveimage 

009. if p.x+p.movex < 0: p.x = 

p.x+600 

010. if p.x+p.movex > 600: p.x = p.x- 
600 

011. if moveimage. get_at((int(p.x+p. 
movex), int(p.y+p.movey-80))) != 

Color( black ): 

012. p.movex = p.movey = 0 

013. 

014. def checkDotPoint(x,y): 

015. global dotimage 

016. if dotimage. get_at((int(x), 

int(y))) == Color( 'black' ): 

017. return True 

018. return False 

019. 

020. def getPossibleDirection(g) : 

021. global moveimage 

022. if g.x-20 < 0: 

023. g.x = g.x+600 

024. if g.x+20 > 600: 

025. g.x = g.x-600 

026. directions = [0,0, 0,0] 

027. if g.x+20 < 600: 

028. if moveimage. get_ 

at( (int(g.x+20), int(g.y-80))) == 
Color( black ): directions[0] = 1 
029. if g.x < 600 and g.x >= 0: 

030. if moveimage. get_ 

at((int(g.x) , int(g.y-60))) == 

Color(' black ): directions[l] = 1 
031. if g.x-20 >= 0: 

032. if moveimage. get_ 

at ((int(g.x-20), int(g.y-80))) == 
Color( black ): directions[2] = 1 
033. if g.x < 600 and g.x >= 0: 

034. if moveimage. get_ 

at((int(g.x), int (g.y-100))) == 
Color(’ black ): directions[3] = 1 
035. return directions 


pacmanl.py 

> Language: Python 3 


00i. 

002 . 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 


028. 


029. 

030. 

031. 

032. 

033. 

034. 

035. 

036. 

037. 

038. 

039. 

040. 

041. 

042. 

043. 


044. 

045. 


import pgzrun 

import gameinput 

import gamemaps 

from random import randint 

from datetime import datetime 

WIDTH = 600 

HEIGHT = 660 

player = Actor ( pacman_o") # Load in the player Actor image 
SPEED = 3 

def draw(): # Pygame Zero draw function 

global pacDots, player 
screen. blit( 'header’ , (0, 0)) 
screen. blit( 'colourmap' , (0, 80)) 
pacDotsLeft = 0 
for a in range(len(pacDots)) : 
if pacDots[a].status == 0: 
pacDots[a]. draw() 
pacDotsLeft += 1 

if pacDots[a] .collidepoint((player .x, player.y)): 
pacDots[a].status = 1 
if pacDotsLeft == 0: player.status = 2 

drawGhostsQ 
getPlayerImage() 
player. draw() 

if player.status == 1: screen.draw. text ("GAME OVER" 

, center=(300, 434), owidth=0.5, ocolor=(255,255,255), 
color=(255,64,0) , fontsize=40) 

if player.status == 2: screen.draw. text( "YOU WIN!" 

, center=(300, 434), owidth=0.5, ocolor=(255,255,255), 
color =(255,64,0) , fontsize=40) 

def updateQ: # Pygame Zero update function 

global player, moveGhostsFlag, ghosts 
if player.status == 0: 

if moveGhostsFlag == 4: moveGhostsQ 
for g in range(len(ghosts)) : 

if ghosts[g] .collidepoint((player.x, player.y)): 
player.status = 1 
pass 

if player.inputActive: 

gameinput .checklnput( player) 
gamemaps. checkMovePoint (player) 
if player.movex or player.movey: 

inputLockQ 

animate(player, pos=(player .x + player.movex, 
player.y + player.movey), duration=l/SPEED, tween= 'linear' , 
on_f inished=inputUnLock) 

def init() : 
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DOWNLOAD 

THE FULL CODE: 



Q magpi.cc/jefHFU 



046. 

global player 


+ dmoves[ghosts[g].dir] [0]*20, ghosts[g].y + 

047. 

initDotsQ 


dmoves[ghosts[g].dir] [1]*20), duration=l/SPEED, 

048. 

initGhostsQ 


tween= 'linear' , on_finished=f lagMoveGhosts) 

049. 

player.x = 290 

094. 


050. 

player.y = 570 

095. 

def flagMoveGhostsQ : 

051. 

player.status = 0 

096. 

global moveGhostsFlag 

052. 

inputllnLockQ 

097. 

moveGhostsFlag += 1 

053. 


098. 


054. 

def getPlayerlmageQ : 

099. 

def ghostCollided(ga,gn) : 

055. 

global player 

100. 

for g in range(len(ghosts)) : 

056. 

dt = datetime. now() 

101. 

if ghosts[g] .colliderect(ga) and g != gn: 

057. 

a = player.angle 

102. 

return True 

058. 

tc = dt. microsecond%(500000/SPEED)/(100000/SPEED) 

103. 

return False 

059. 

if tc > 2.5 and (player.movex != 0 or player.movey 

104. 



!=0) : 

105. 

def initDotsQ: 

060. 

if a != 180: 

106. 

global pacDots 

061. 

player.image = "pacman_c" 

107. 

pacDots = [] 

062. 

else: 

108. 

QJ 

II 

X 

II 

© 

063. 

player.image = "pacman_cr" 

109. 

while x < 30: 

064. 

else: 

110. 

© 

ii 

>> 

065. 

if a != 180: 

111. 

while y < 29: 

066. 

player.image = "pacman_o" 

112. 

if gamemaps.checkDotPoint(10+x*20, 10+y*20) 

067. 

else: 

113. 

pacDots. append (Actor ( "dot" , (10+x*20, 

068. 

player.image = "pacman_or" 


90+y*20) )) 

069. 

player.angle = a 

114. 

pacDots[a].status = 0 

070. 


115. 

QJ 

+ 

II 

l-> 

071. 

def drawGhostsQ : 

116. 

y += 1 

072. 

for g in range(len(ghosts)) : 

117. 

\ i 

ii 

+ 

X 

073. 

if ghosts[g].x > player.x: 

118. 


074. 

ghosts[g].image = "ghost"+str(g+l)+"r" 

119. 

def initGhostsQ : 

075. 

else: 

120. 

global ghosts, moveGhostsFlag 

076. 

ghosts[g].image = "ghost"+str(g+l) 

121. 

moveGhostsFlag = 4 

077. 

ghosts[g] .drawQ 

122. 

ghosts = [] 

078. 


123. 

g = 0 

079. 

def moveGhostsQ : 

124. 

while g < 4: 

080. 

global moveGhostsFlag 

125. 

ghosts. append (Actor ("ghost "+str(g+l) 

081. 

dmoves = [(1,0),(0,1),(-1,0),(0,-1)] 


, (270+(g*20) , 370))) 

082. 

moveGhostsFlag = 0 

126. 

ghosts[g].dir = randint(0, 3) 

083. 

for g in range(len(ghosts)) : 

127. 

g += 1 

084. 

dirs = gamemaps.getPossibleDirection(ghosts[g] ) 

128. 


085. 

if ghostCollided(ghosts[g] ,g) and randint(0,3) 

129. 

def inputLockQ: 


== 0: ghosts[g].dir = 3 

130. 

global player 

086. 

if dirs[ghosts[g].dir] == 0 or randint (0,50) == 

131. 

player.inputActive = False 


0: 

132. 


087. 

d = -1 

133. 

def inputllnLockQ: 

088. 

while d == -1: 

134. 

global player 

089. 

rd = randint(0,3) 

135. 

player.movex = player.movey = 0 

090. 

if dirs[rd] == 1: 

136. 

player.inputActive = True 

091. 

d = rd 

137. 


092. 

ghosts[g].dir = d 

138. 

initQ 

093. 

animate(ghosts[g], pos=(ghosts[g] .x 

139. 

pgzrun.goQ 
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and Jam organiser. 
His Pi now controls 
more of his house 
than he does. 

mrpjevans.com 
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Hack smart lights 



On and off? Dimming? We can do better than that, Take control 
of your lights with a Pi and link them to just about anything! 


S mart lighting has been around for a few 
years now and, in terms of reliability and 
functionality, the technology has come a 
long way. Best of all, the cost of implementation 
has plummeted. Not only are smart lights 
affordable, there's a great range of products to 
choose from and some are hackable! Using IKEA’s 
Tradfri range, we’re going to improve our smart 
lighting setup by adding some Pi magic, and then 
linking the lights to the outside world to create a 
bit of Christmas fun. 


provided remotes. That’s not the case if we want 
to hook things up to a Raspberry Pi or the internet. 
To allow smartphones to control lights, IKEA has 
released an inexpensive gateway that bridges 
the gap between ZigBee and your network. All it 
requires is USB power (charger included) and a 
wired connection to your network. Now, install the 
Tradfri app (iOS and Android) on your phone and 
follow the instructions. 


Zig-a-Zig(Bee)-Ah 

The Tradfri range uses the popular ZigBee 
radio system to communicate. No central hub is 
needed for basic light switching - you just use the 


Lighten up 

As you work through the app’s setup 
procedure, you will be asked if you want to 
configure your devices. You’ll need to plug your 
light in now. All Tradfri lights have Edison screws 
- if you need an adapter for bayonet fittings, IKEA 


You'll Need 


> IKEA Tradfri Colour 
Smart Light 

magpi.cc/zFhgHN 

> IKEA Tradfri 
Gateway 

magpi.cc/AUqvsQ 

> IKEAKOPPLA 
Edison screw to 
bayonet converter 
(optional) 

magpi.cc/kSMDAC 
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sells these too for a princely £1. You’ll also need 
the remote control provided to sync the light up 
with both it and the gateway. It’s a reasonably 
painless process, and by the end you should be able 
to control the light with your phone as well as the 
remote. Don’t proceed until you’ve confirmed this. 


network and displays the IP address of everything 
it finds. You’re looking for a device with the name 
GW-XXXXXXXXXXXX, where the value of the Xs 
can be seen on the underside of the gateway, under 
( MAC’. Fing will also display ‘TRADFRI-Gateway’. 


Here’s everything you 
need: a smart Light 
internet gateway, 
remote control, 
and, optionally, 
a socket adapter 


Be prepared 

Once you’ve finished changing the light to 
all the colours of the rainbow, make sure you’ve got 
a Pi ready to go. You’re only going to be working 
on the command line, so Raspbian Stretch Lite is 
perfect. If you’ve got Raspberry Pi Desktop for x 86 , 
any popular Linux distribution, or even macOS, the 
following instructions will work on these platforms 
too. This is a zero-solder project and we’re not using 
the GPIO this time. All that’s needed is a network 
connection. Just make sure you’ve done sudo apt 
update && sudo apt upgrade before you start. 


We're all going on a gateway hunt 

Before we can talk to the gateway, we need 
to find it, and that means we need its IP address. 
Probably the easiest place to discover it is by 
accessing your router’s webpage, as most routers 
display a list of connected devices. Otherwise, 

Fing, a free app for Android and iOS, scans your 


Learning to CoAP 

The Tradfri gateway speaks CoAP, a protocol 
designed for the Internet of Things. It’s lightweight, 
fast, small, and capable of communicating with 
millions of devices. Raspbian does not speak CoAP, 
so we need to teach it. From the command line, 
we’ll download some libraries, compile, and install 
them. Enter the following, line-by-line from your 
home directory: 


sudo apt install git automake libtool 
python3-pip 

git clone --depth 1 --recursive -b dtls 
https://github.com/home-assistant/libcoap. 
git 

cd libcoap 
./autogen.sh 

./configure --disable-documentation 
--disable-shared --without-debug 
CFLAGS="-D COAP_DEBUG_FD=stderr" 
make 

sudo make install 
pip3 install pytradfri 


Top Tip 


Don't like 
meatballs? 


There are many 
other hackable 
systems on sale, 
such as Philips 
Hue. If Tradfri 
doesn’t meet 
your needs, 
shop around! 
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Open a communications channel 

We’ve now installed libcoap and pytradfri, 
a Python 3 library for talking CoAP to the 
gateway. This library, written and maintained by 
‘ggravlingen’ on GitHub, allows us to talk with 
the various devices easily and without knowing 
anything about the underlying protocols at work. 
It also comes with a testing script, so let’s start 
with that. 


python3 -i -m pytradfri <IP-Addness> 


Replace ( <IP-Address>’ with the address of the 
gateway, as discovered in Step 4. You’ll be asked 
the security code on the base of the gateway, after 
which you’ll see a list of available commands and 
the familiar Python prompt. 


Coding light 

Time for some code. When you entered 
your security code in the previous step, a file was 
created called tradfri_standalone_psk.conf This 
contains your unique password for communicating 
with the gateway. Create all the following scripts in 
the same directory as this file. 

In the script shown here, change the IP address 
to match your gateway and run using Python 3: 


python3 brighten.py 

The code locates the password in the saved file 
and then interrogates the gateway to discover 
available devices. Once we have our lights array, 
a simple loop takes our light from minimum to 
maximum brightness. 


It's time to light the lights 

Let’s test the light. At the Python prompt 
(»>), type... 


Top Tip 4 


Use the GPIO 
for more fun 


Connect any 
number of buttons 
or sensors to your 
GPIO pins and 
have your house 
Lights react. 


lights 

.. .followed by ENTER. All being well, a 
description of your light will be displayed as part 
of an array. Seeing this confirms that your Pi is 
talking to the gateway! Now, let’s see if we can 
command our light. Make sure the light is on and 
enter the following at the Python prompt: 

api(light.light_control.set_dimmer(0)) 


Seethe light 

We can also monitor the state of Tradfri 
devices, including lights. The pytradfri library 
supports requests on the state of devices, including 
whether they are on or off and their current 
brightness level. A separate thread monitors 
the gateway for changes and keeps our variables 
up to date. 

Download this script: magpi.cc/qDqTXf. Change 
the IP address and run it in the same directory as 
the .conf file. Now watch the output while you 
adjust the brightness using the remote control. As 
the Tradfri range also includes PIR sensors, you’ve 
got the beginnings of a home security system. 
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▲ Connect your Lights to the outside world and Learn 
about APIs with the fun Cheerlights community 


Some Christmas cheer 

You can link your light to anything you like. 
As it is Christmas, we’re going use Cheerlights 
(cheerlights.com), a service that allows Twitter 
users to set the colour on thousands of light 
devices around the world. It’s also a great way to 
learn about APIs, thanks to its simplistic design. 

Download the code from magpi.cc/ettkzk to 
the same directory as the .conf file from earlier. 
Change the IP address, run the script, and watch 
the light change colour. The code requests the 
current colour from the Cheerlights API at regular 
intervals and sets the light to match. Tweet a 
colour to @ cheerlights and change it yourself! 


Let the light flow 

Most actions in home automation come 
down to basic cause and effect: 'if this happens, 
do this thing’. So it’s no surprise that one of the 
most popular automation services is called IFTTT 
('If This Then That’). IFTTT supports a huge range 
of internet services and IoT devices, acting as a 
'middleware’ to connect things together. Using its 
'Webhooks’ service, you can trigger any of IFTTT’s 
actions. A Webhook is a unique URL that, when 
called, triggers an action, whether that’s sending 
an email or switching on a coffee machine. Here’s 
some example code to call an IFTTT Webhook: 
magpi.cc/CSCdNK. 


Going further 

Tradfri plus Raspberry Pi plus IFTTT opens 
up a world of possibilities. Tradfri isn’t just for 
lighting: there are PIR sensors now available and 



> Language: Python 3 


DOWNLOAD 
THE FULL CODE: 


I® magpi.cc/ntxpZk j 


001. 

002. 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 

028. 

029. 

030. 

031. 

032. 

033. 


from pytradfri import Gateway 

from pytradfri.api.libcoap_api import APIFactory 
from pytradfri.util import load_json, save_json 
from time import sleep 

# Change this IP address to your gateway 

IP_ADDRESS = 192.168.0.158' 

# Make sure you're in the same directory as this file 
CONFIG_FILE = 'tradfri_standalone_psk.conf' 

# Load in the file, get our password for the gateway and 
create an API 

conf = load_j sort (CONFIG_FILE) 

identity = conf[IP_ADDRESS]. get (' identity' ) 

psk = conf[IP_ADDRESS] .get (' key' ) 

api_factory = APIFactory(host=IP_ADDRESS, psk_id=identity, 
psk=psk) 

# This section connects to the gateway and gets information 
on devices 

api = api_factory.request 
gateway = Gateway () 

devices_command = gateway .get_devices() 
devices_commands = api(devices_command) 
devices = api(devices_commands) 

# Create an array of objects that are lights 

lights = [dev for dev in devices if dev.has_light_control] 

# Brightness ranges from 0 to 254., so lets set the light in 
stages of 5 

for brightness in range(0, 255, 5): 

# Set the first light to 'brightness' and then pause 
for a moment 

api(lights[0] .light_control. set_dimmer(brightness) ) 
sleep(0. 1) 


smart sockets are on the way. The lights are also 
available in a range of sizes, perfect for projects 
involving bedside lamps or kitchen lighting. 
Whether you want to make a mood detector, 
ambient lighting system or add home security, 
this is a great low-cost way to start. IKEA is openly 
supporting the community and encouraging people 
to make use of the Tradfri range. Of course, there’s 
plenty of scope for fun and mischief too! E3 
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▼ Backwards 

compatibility with 
init.d scripts - and 
even run Levels 
- is maintained 
by systemd 


Start and stop 

at your command 

Use the command line to start and stop services, 
and auto-run them at startup 


O ver the last few years, every major GNU/ 

Linux distribution - Raspbian included - has 
changed the way that it starts up. This means 
that much of the older literature on bookshelves 
and websites, dealing with where to put files 
in rc.local to get them to automatically run on 
startup, is no longer correct - unless you’ve yet to 
upgrade from Raspbian Wheezy. 

One thing remains the same. Although the 
first process the kernel starts is not /sbin/init, but 
/lib/systemd/systemd (still with a PID of l), it is 
still the parent process of everything that happens 
in user space once the Linux kernel has finished 
initialising devices and drivers, and mounted the 
file system. 

The init process gets everything else started, 
and usually ends with the prompt inviting you to 
log in to your Pi. Recent versions of Raspbian hide 
most of the messages that this startup process 
generates, but you can see them by typing dmesg. 
They’re also stored in /var/log/kern.log. 

Startup - init - is the start of user space; this is 
the place where you can put your own programs to 


affect how the Pi runs, without having to modify 
the code of your Linux kernel! Traditionally, 
GNU/Linux distributions implemented a version 
of the UNIX System V init, which had a well- 
defined startup process with run levels that would 
indicate whether the system was at startup, c single 
user mode’ (rescue mode - a handy way to get back 
in when you’ve lost your password, or a security 
headache), console mode, the GUI, or heading 
for shutdown. 

Along the way, files in /etc with names 
beginning rco through rc6 get called - running 
startup scripts in /etc/init.d - and /etc/rcS.d, 
which contains files always called at startup, 
regardless of run level. Those /etc/init.d scripts 
can be called directly to start or stop your 
databases, web servers, or anything else that needs 
intervention. Many support further commands 
such as status, to check a service is running 
properly, and reload - the latter is useful if 
you want a service to take a look at fresh config 
settings without doing a full restart. 

sudo /etc/init.d/couchbase-server status 


File Edit Tabs Help 


pi@raspberr... x | pi(5)raspberr... x I 


ff Should-Stop: 
ff X-Start-Before: 
ff x-Stop-After: 
ff Default-Start: 

# Default-Stop: 

# X-Interactive: 

# Short-Descrlption: 

Sportmap 

nis 

nis 

2 3 4 5 

0 1 6 
true 

Example initscript 




ff Description: This file should be used to construct scripts to 

ff placed in /etc/init.d. 

### END INIT INFO 

More information on the format is available from insserv(8). This 
information is used to dynamiealy assign sequence numbers to the 
boot scripts and to run the scripts in parallel during the boot. 

See also /usr/share/doc/insserv/README.Debian. 
piPraspbcrrypi: /etc/systemd $ Is /etc/init.d 

be 


alsa-utils 

dphys-swapfile 

mountall.sh 

rc 

ssh 

avahi-daemon 

fake-hwclock 

mountdevsubfs.sh 

rc.local 

sudo 

bluetooth 

halt 

mountkernfs.sh 

rcS 

triggerhappy 

bootlogs 

hostname.sh 

mountnfs-bootclean.sh 

README 

udev 

bootmisc.sh 

hwc lock.sh 

mountnfs.sh 

reboot 

udev-finish 

checkfs.sh 

kbd 

networking 

rmnologin 

mount fs 

' ■ .! >' I..',:...' 1 .;-:. 

.sh keyboard-setup 

nfs-camnon 

rpcbind 

mountnfs.sh 

checkroot.sh 

killprocs 

ntp 

rsync 

mountroot 

console-setup 

kmod 

Plymouth 

rsyslog 

urandon 

cron 

lighten 

Plymouth-log 

sendsigs 

xl 1 -cannon 

dbus 

motd 

procps 

single 


■dhcpcd mountall-bootclean.sh 

|pt@raspberrypi: /pt 

raspi-config 

skeleton 



Although the regular and predictable scripted 
startup of Sys-V init makes it easy to place your 
own programs in the startup process - particularly 
useful on an unattended Pi - the performance of a 
purely sequential startup process is poor, even when 
booting from a solid-state drive. Enter systemd... 


Systemd 

Systemd can start services in parallel, and can 
defer service starts until they are needed. Rather 
than many scripts for individual components, 
a target is set, and systemd resolves the 
dependencies until it reaches that target, 
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root root 
root root 


♦ 


|pi@raspberrypi/etc/ 


|pi(5)raspberrypi:~ 


pi@raspberrypi: /etc/systemd 


d File Edit Tabs Help 


1 pi@raspberr... * pi(®raspberr x 


pi£raspberrypi: /etc/systemd t Is system/* X 

system/autologin®.service system/dhcpcd5 \ 

system/dbus-org.bluez.service system/display-manager.service 

system/dbus org.freedesktop.Avahi.service system/syslog.service 



system/bluetooth.target.wants: 

bluetooth.service 


Following Raspbian Jessie’s 

system/dhcpcd.service.d: 


move to systemd, systemctl 

system/getty.target.wants: 

gettyettyl.service 


replaces service to restart, or 

system/getty@tty1.service.d: 


query status, of server software 




iPraspberrypi:- S Is 

atal 0 

rwxrwxrwx 1 root root 
rwxrwxrwx 1 root root 
rwxrwxrwx 1 root root 
rwxrwxrwx 1 root root 
rwxrwxrwx 1 root root 
ost_keys . service 
rwxrwxrwx 1 root root 
rwxrwxrwx 1 root root 


1 /etc/systerad/system/multi-user.target.wants/ | 

40 Jun 21 08:48 avahi daemon,service > /lib/systemd/system/avahi-daemon.service 
32 Jun 21 08:31 cron.service -> /lib/systemd/system/cron.service 

34 Jun 21 08:53 dhcpcd.service > /lib/systemd/system/dhcpcd.service 

35 Jun 21 08:50 heiuart.service -> /lib/systemd/system/hciuart.service 

52 Jun 21 08:52 regenerate_ssh_host_keys.service -> /lib/syste»d/system/regeneratc_ssh_ 

36 Jun 21 08:30 remote-fs.target -> /lib/systemd/system/remote-fs.target 
35 Jun 21 08:33 rsyslog.service -> /lib/systemd/system/rsyslog.service 
31 Jul 3 15:19 ssh.service -> /lib/systemd/system/ssh.service 

37 Jun 21 08:50 sshswitch.service > /lib/systeflid/system/sshswitch.service 


Adding a service to systemd 
creates a symlink to its real 
Location as part of the process 
don’t do it manually 


avoiding any fixed startup sequence along the 
way. Files are found under /etc/systemd/system 
and there’s a lot to learn, but as Raspbian now 
starts up far more quickly, at least we’ve created 
extra time for all that learning. The one thing 
to remember for any user is that systemd and 
its service manager are controlled with the 
systemctl command: 

sudo systemctl restart ssh 

...will restart the SSH server - something you’ll 
need to do if you change the port it listens on, for 
example. For compatibility, as well as /etc/init.d 
scripts to start and stop services, the system of 
service commands that worked on older versions of 
Raspbian, such as sudo service apache2 reload, 
still works (here we ask a running Apache 2 web 
server to reread its configuration files). 

In/etc/systemd/system/multi-user.target.wants 
you’ll find files like openvpn.service which, when 
examined closely with Is - 1 , you’ll see are links 
to files of the same name in /lib/systemd/system 
(other GNU/Linux distributions may place the 
files under /usr/lib). Don’t worry if what’s inside 
these files looks confusing; there’s a logic to them 
with their conditional dependencies, but you can 
safely forget about them until you need to get some 
software working automatically on every system 
restart for your Pi project. Even then, we’ll show 
you another way with crontab - otherwise you’ll 
need to be aware of the following, as those links 
aren’t created manually: 


sudo systemctl enable postgnesql.service 

...will create the link, and means PostgreSQL 
will be enabled upon startup. To control the service 
before the next restart: 

sudo systemctl daemon-reload 

...will make systemd aware of the changes. 


Linked In 

Systemd makes links between files automatically, 
but there will be times you’ll want a file to appear 
to be in a local directory when it is elsewhere, with 
a handy little command we have not so far had a 
chance to show you: In. 

In makes a link which allows a file to effectively 
exist in two places at once. In the example: 

In -s /backupdisk/important/essayl2.txt 
important-essay.txt 

...(where /backupdisk/important should be 
replaced by the actual path to a directory on your 
backup disk or eleswhere, and essayl2. txt by 
the name of a file there) a file will appear in your 
current working directory. But Is -1 and you’ll 
see that it’s a special type of file, a link pointing 
to the actual file. Edit important-essay.txt and 
you’ll find that essayi2.txt on the backup disk will 
be edited. Soft, or ‘symbolic’ links, are created 


Top Tip 


Who / Where 


Although run 
levels are no 
longer particularly 
meaningful under 
systemd, you can 
still check which 
run level you are 
in with who -r. 
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with the -s switch - you don’t even need the file 
to which you’re linking to actually exist, which 
makes it handy if linking across a network, or to a 
removable drive. 

It’s called a symbolic link because it works by 
linking to the name of the target file, rather than 
to the file data itself. Create a hard link: 


In /etc/apaches2/apache2.conf 
myapache2.conf 


□ Remove the original file in the hard link 
case, and the link still points to the data 2] 


Top Tip 


Systemd dot 


Systemd is a 
complex system, 
with many 
components, from 
systemd.unit 
to systemd.slice 
- but they all 
have their own 
man pages, 
and it’s worth 
reading through 
to help get the 
overall concept. 


...and you have two names (and locations) for 
the same file - sounds like the same thing? Not 
exactly: if you delete the original file in the first 
example, you can replace it with a new file of 
the same name, but different contents, and the 
symbolic link will point to the new file. Remove the 
original file in the hard link case, and the link still 
points to the data. 


Location, location 

The startup scripts - whether init.d or systemd 
- are generally for daemons: processes you want 
running all of the time, like web servers and 
databases. There are plenty of programs which do 
housekeeping that need to be run periodically - 
hourly, daily, weekly. For this purpose, the cron 
software utility is ideal for scheduling the running 


File Edit Tabs Help 
f pi@raspberr x~j pi@raspberr... x 


>i@raspberrypi: \ Is /etc/cron* 

'etc/crontab 


of such programs and tasks. Cron searches its 
configuration directories and runs through the 
scripts it finds there - have a look at the various 
folders in /etc with names beginning with cron. 

The easiest way to get to know where things like 
this are on your system is to search with locate 
- which is not installed by default on Raspbian. 
Enter apt-get install mlocate, to get the best 
version, then locate cron - which will find you 
every file or directory with cron as its name or as 
part of its name. 

The locate tool maintains a database of every 
file on the system, which itself is updated daily by 
cron. If you’ve made a lot of changes, or want to 
find out where some software you’ve just installed 
has put its config file, get locate to update its 
database with sudo updatedb. 

The built-in alternative is find, a powerful 
utility which enables you to search particular 
directories - or the whole file system - by name 
or name fragment, size of file, how long ago 
they were modified, or whether they’re bigger 
than another file. Because it searches the file 
system, rather than a cached listing, it takes 
longer than a locate, but it is always up to date, 
and has search options not found in locate (see 
‘RegExp’ box). To replicate our locate cron 
command with find: 

find / -name '*cron*' 

If you were looking for cron or crontab, but not 
anacron, you could search for 'cron* ' instead. 
There will be more output than you want, so pipe 
it through a pager, or perhaps a grep. Back to 
using cron - the easiest way is via crontab, which 
maintains a table where each row specifies a 
command and how often it is to run. You edit the 
crontab file not directly, but with crontab -e, 
which calls up the default text editor to do the job. 
Add an entry in the form: 


/etc/cron.d: 

/etc/cron.daily: 

apt aptitude bsdmainutils dpkg logrotate man db ntp passwd 

/etc/cron.hourly: 

fake-hwclock 

/etc/cron.monthly: 

/etc/cron.weekly: 

man db 

pi£raspberrypi:- S Is /etc/cron.daily 

apt aptitude bscfaainutils dpkg logrotate man-db mlocate ntp passmd 

piPraspberrypi:- t | 


▲ Installing mLocate adds a script 
to /etc/cron.daily to update 
its database of files and foLders 
every day 


45 05 * * 1-5 calendar | mail -s 'Your 
calendar' me@myemailaddress.com 

...to take an example from Michael Stutz’s 
Linux Cookbook (No Starch Press); this will grab 
the output from the venerable UNIX calendar 
program and email it to you every morning. The 
first five crontab fields cover minute, hour, day 
of month, month, day of the week, and can all be 
replaced with a single special value, like @daily 
or @hourly. While man crontab tells you a little 
about crontab, man 5 crontab is far more useful 
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I*" Google - Chromium 


5 t tl £*|21:15 


pi@)raspbenypi: ~ 


File Edit Tabs Help 
pi@raspberr X | pi@>raspberr. 


1.875959] 
1.879412) 
1.879775] 
1.879855J 
1.885243) 
1.885262) 
1.888646) 
1.9790601 
2.071091J 

2.0B8542) 

2.217795) 

2.217826) 

2.217846) 

2.217869) 

2.237851) 

2.238479) 

2.405409) 

2.534806) 

2.698054) 

2.698083) 

2.698094) 

2.698103) 

2.724585] 

2.785842) 


smsc95xx 


1729) 


2.905565) 

3.023791) 

4.041224) 

4.265680) 

4.410507] 

4.959072) 

6.827138] 

6.827168) 

7.195795) 


8.566391) 

8.566602) 

11.630479) 

11.630574) 


new high-speed USB device number 3 using dwc„otg 

Cannot add dependency job for unit ref»enerate sxh_host keys.service, ignoring: Unit regenerate_ssh_host_keys.service fa! 

Starting Forward Password Requests to wall Directory Watch. 

Started Forward Password Requests to Wall Directory Watch. 

Starting Remote File Systems (Pro). 

Mew USB device found, idvendor-0424. ldProduct-ecOO 
llew USB device strings: Mfr>0. Product-0. SerialHuaber-0 
.0.5 

smsc95xx 1-1. 1:1.0 ethO: register 'smsc95xx' at usb-3f980000.usb-1.1, smsc95xx USB 2.0 Ethernet. b8:27:eb:29:c3:e4 
fuse init (API version 7.26) 

usb t-1.3: new low-speed USB device number 4 using <K*c_otg 
i2c /dev entries driver 

usb 1-1.3: Men USB device found. idvendor-046d. idProduct*c00l 
usb 1-1.3: Mew USB device strings: Mfr-1, Product-2, SenalHimiber-0 
usb 1 1.3: Product: USB Mouse 
usb 1-1.3: Manufacturer: Logitech 

input: Logitech USB Mouse as /devices/platform/soc/3f980000.usb/usb1/1>1/1-1.3/1-1.3:1.0/0003:0460:COO1.OOOI/input/inputO 

hid-genenc 0003:046D:CO0 1 .0001: input.hidrawO: USB MID vl.10 Mouse (Logitech USB Mouse] on usb-3f980000.usb-l .3/inputO 

systend-udevd[ 146] : starting version 215 

usb 1-1.5: new low-speed USB device number 5 using dwc.otg 

usb 1-1.5: Mew USB device found. idvendor-049f. idProduct-0004 

usb 1-1.5: Mew USB device strings: Mfr-1. Product-2. SerialMimber-0 

usb 1-1.5: Product: USB Keyboard 

usb 1-1.5: Manufacturer: SILITEK 

input: SILITEK USB Keyboard as /devices/platform/soc/3f9S0000.usb/usb1/l-l/1-1.5/1-1.5:1.0/0003:049F:0004.oo02/input/inputl 
hid-genenc 0003:049F:0004.0002: input.hidrawi: US8 HID vl.00 Keyboard (SILITEK USB Keyboard) on usb-3f980000.usb-1.5/input0 
input: SILITEK USB Keyboard as /devices/platform/soc/3f980000.usb/usbl/1-1/1-1.5/1-1.5:1.1/0003:049F:0004.0003/input/input? 
lud-generic 0003:049F:0004.0003: input.hiddev0.hidraw2: USB HIO vl.00 Device (SILITEK US8 Keyboard] on usb-3f980000.usb-l.5/inputl 
EXT4-fs (mmcblkOp?) : re-mounted. Opts: (null) 

gpiomom-bcm2835 3f200000.gpiomem: Initialised: Registers at 0x3f200000 
usbcore: registered new interface driver brcmfmac 

brcmfnac: Firmware version • wlo: May 27 2016 00:13:38 version 7.45.41.76 (r640327) FWIO 01-df77e4a7 

systemd-journald|l39) : Received request to flush runtime journal from PID 1 
IPv6: ADDRCOMF(METDEV_UP): wlanO: link is not ready 
brcmfmac: power management disabled 

uart-plOii 3f20l000.serial: no DMA platform data 

Adding 102396k swap on /var/swap. Priority:-l extents:6 across:2559996k SSFS 

smsc95xx i-i.i:i.o ethO: hardware isn’t capable of remote wakeup 
IPv6: ADDRCOHF(METDEV_UP): ethO: link is not ready 
Core ver 2.22 


i load: No such file or directory. 


11.631409) 

11.631425) 

11.631462] 

11.642487) 

11.642501) 

11.642507) 

11.642701] 

11.814426) 

11.814455) 

11.814472) 

28.386500) 

2203.377875) 

2203.378584] 

>i£raspberrypi: 


Registered protocol family 31 

tooth: MCI device and connection manager initialized 
tooth: HCI socket layer initialized 
tooth: L2CAP socket layer initialized 
tooth: SCO socket layer initialized 
tooth: MCI uart driver ver 2.3 
tooth: MCI UART protocol H4 registered 
tooth: MCI UART protocol Three-wire (H5) registered 
MCI UART protocol Broadcom registered 
BIIEP (Ethernet Emulation) ver 1.3 
BMEP filters: protocol multicast 
uuetooth: BMEP socket layer initialized 
andom: crng init done 

Pv6: ADDRCOMF(METDEV_CHANGE): ethO: link becomes ready 
"v.,c!/5'’ i-i. 1:1.0 ethO: link up. 10Mbps. half-duplex, lpa 0x0020 
I dmesg | 


iluetoc 


dmesg gives you the 
startup messages from 
the kernel - nuggets 
of useful info buried 
in plenty of Legacy 
boot information 


as it covers the layout of the file, with examples. 
Run man man for more on the numbered sections 
available with man commands. 

Note that traditional UNIX command-line mail is 
not installed by default on the Pi, so if you wanted 
to follow the example, you’d need to install a simple 
mailer - we recommend ssmtp, and the Raspberry 
Pi forums contain plenty of tips on command-line 
mail, as it can be used in all sorts of projects. 


A fresh startup 

Using the value ^reboot, we can easily run our 
own scripts on startup, without messing about 
with system startup scripts. There are times 
when a full systemd startup script will be more 
appropriate, but for quickly getting something 
tested, put the script into crontab. 

There are two things that may catch you out. 
Firstly, you might be running scripts out of a 
directory that you have in your $PATH, which 
defines where Bash looks for commands. As $PATH 
is only set once you log in and your personalised 
.bashrc file is read, scripts running from crontab 
which are run immediately upon startup will not be 
aware of your $PATH setting. So, you will need to 
express all commands by their full paths, such as 
/home/pi/bin/test.sh - as well as making sure that 
the permissions are sufficient. 

Secondly, systemd’s parallel service starts also 
mean that some services, such as the network, as 


well as environment variables, may not be ready 
when your ^reboot commands are called. If you 
have problems, try giving a short pause first. It’s 
ten seconds in this example crontab entry, but you 
could use the smallest time that consistently works 
on testing: 

(Sreboot sleep 10; /usr/bin/python3 /home/ 
pi/Documents/Python_Projects/hello_gpio.py 

One of the scripts that you’ll see called by cron 
is to run anacron, designed to periodically run 
tasks on machines that were not always switched 
on - so it is very useful on laptops, too - with tasks 
specified, in anacrontab, to run after so many days 
have passed since they last ran. You can also use 
the automation of crontab or anacron to run your 
own backup scripts. EH 


Top Tip 


RegExp 


The find tool can 
search by Regular 
Expressions, as 
well as (part) 
name. They're a 
whole book topic 
in themselves, 
but well worth 
investigating 
once you've got 
command-line 
basics under your 
belt, as regexps 
can be used with 
many commands. 



Conquer the 
Command Line 


For more terminal tutorials, take a 
Look at our Essentials book, Conquer 
the Command Line. Discover the 
power of the command Line to 
simplify complex tasks, or instantly 
carry out simple ones. 
magpi.cc/Essentials-Bash 
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The Matrix is an undedicated array of switches and lights 
that can be put to any number of uses - animated light 
displays, games, controlling synthesizers, and more 


W ith the hardware finished, and tested, 
it is now time to see how we can use it 
with the minimum of user complexity. 
By providing a simple user interface, we can 
begin to explore all the potential of The Matrix, 
without having to worry about the registers in the 
matrix driver. 


Why a class library? 

Last month we published some code to 
get the matrix working. There was a bunch of 
functions you could use to do things like look 
at switches, transfer data into the MAX7219, 
and light LEDs. The aim was just to produce a 
quick and dirty test to try out the hardware and 
spot any wiring faults. The functions were not 
designed to be easy to use and were too close to 
the hardware. With a class library, we can present 
a clean useful interface to the user without them 
needing to know the dirty bits of the hardware. 
This abstraction is known as an API (application 
programming interface). 


The switches 

The latching switches on the lights simply 
connect the multiplexing cathodes in the matrix 
to a GPIO pin. When connected, you get pulses 
on the GPIO pins; when not connected, the pins 
would float, so we arrange for the pins to have the 
internal pull-down resistors enabled. The signals 
we get are shown in Figure 1 . This presents a bit 
of a problem for a Linux-based computer such as 
the Raspberry Pi, as these pulses are fast and you 
can’t guarantee to always see them - or indeed, 
as we want, to miss them. So, following advice 
on the Raspberry Pi forums, we turned to the 
pigpio library. 


What is pigpio? 

Pigpio is a GPIO interface, but this one 
has a new feature: a glitch filter. That is, we can 
set it to ignore any small changes in the signal 
level and only report longer-term steady levels. 
This is exactly what we want here. We can set the 


▼ Figure l Signals received on the GPIO pins 
for switch closed and open 
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80uS 


Figure 1 
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1 

0 - Switch Open 
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glitch filter to ignore the logic low pulses and use 
a callback function when the level changes from a 
one to zero, or zero to one. Both transitions tell us 
a switch has changed, and we can use the callback 
function to set a Boolean flag in a switch list. 


The switch API 

So what we want to do to read the switches 
is to call a method in our class library which will 
return what switch number has been pressed. If 
nothing has been pressed since the last time we 
asked the API, then the value -1 is returned. This 
is handled by the getSwitch method of our class 
library. Note that if more than one switch has 
been pressed, this method will only return the 
lowest switch number; if this situation is possible, 
the user will need to make successive calls to this 
method until you see a -1 returned. 


Figure 2 


LED control 
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4 Figure 2 User's 
view of bits for 
the LED controls 
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Top Tip 


More examples 


We have a few more examples of using this class 
library in the GitHub repo (magpi.cc/iNqJjmV). 


The LEDs 

Translating the LEDs that need to be on, in 
any one switch, into the register settings in the 
MAX7219 is a bit more complex. This is because 
each register actually controls two switches’ worth 
of LEDs. Figure 2 (previous page) shows how we’d 
like the user to think of the LEDs: a simple 4-bit 
value that’ll set which LEDs are on for each switch. 
The set Led method does this. It is called with the 
switch number, and a number corresponding to the 
required bit pattern. This overwrites any previous 


value, but you might want to add a colour to a 
previous pattern, so the addRed, addGreen, and 
addBlue methods are provided as well. 


More LED methods 

To make things even simpler, we have 
added a few more methods. The setRed, setGreen, 
and setBlue methods just set that LED to be lit in 
a switch, and the clrLEDs turns off all the LEDs on 
the matrix. Also, if you want to find out what LEDs 
are lit on a switch, the get Led method will return 
the colour number bit pattern for an LED, in the 
same format used by the set Led method. Finally, 
the setBrightness method takes a number 
between 0 and 15 to control the brightness. Note 
that a value of zero is not off, but the minimum 
brightness of V 32 of the maximum brightness. 


Registers 


Name Address 

No op 

0x0 

Digit 0 

0x1 

Digit 1 

0x2 

Digit 2 

0x3 

Digit 3 

0x4 

Digit 4 

0x5 

Digit 5 

0x6 

Digit 6 

0x7 

Digit 7 

0x8 

Decode 

0x9 

Intensity 

OxA 

Scan Limit 

OxB 

Shutdown 

OxC 

Test 

OxF 


Housekeeping methods 

The two final methods are what we call 
housekeeping methods: those to start up and close 

down the class library. The_ init _function is 

called automatically when you make an instance of 
this class. It is where you set what GPIO pins to use 
for the clock, data, and load pins used to bit-bang 


A Figure 3 The MAX7219 
internaL registers 


Figure 3 
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DO 

point 

a 

b 

c 
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G 

f 
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I 


I 


Segment controls for Digit 0 


Red 

Green 


Red 

Green 


0) 

3 

■ H 

Ph 


Blue 


For Switch 0 


Blue 

- A Figure 4 The LEDs 

controlled by each 

For Switch 4 of the digit registers 


the MAX7219 multiplexer chip. You also set the 
initial brightness with this call. The cleanup 
method puts the MAX chip into shutdown so it is 
not multiplexing, and also frees up the callback 
vectors, clears the glitch filter, and stops pigpio 
from running. We recommend calling this method 
before the code terminates. 


More about the MAX7219 registers 

Figure 3 shows the register structure 
for the MAX7219 chip. Most of them are 
concerned with the LED segments, which are the 
coloured LEDs in our project. The chip’s data sheet 
(magpi.cc/JPjHhi) tells the full story; Figure 3 
shows a simplified version for our project. We’re 
not using any feature of the scan limit or decode 
functions, so these must be set to zero. The 
intensity control is used to set the brightness, and 
the shutdown for the start/stop function. The scan 
limit register will allow you increase refresh rates if 
you are using fewer than the maximum number of 
digits (8), so we don’t need anything here either. 


Segments to LEDs 

For each digit, there is a segment control 
register; the circuit we used means that each of 
these controls the LEDs for two switches - as 
shown in Figure 4. As you can see, it is nothing 
like the simple API model we used in the methods 
to control the LEDs. The translation from one 
to the other is done in the library code, and so 
this complication is hidden from the user of the 
class library. Registers for digits 0 to 3 control the 
LEDs on switches 0 to 7, and registers digits 4 to 8 
control switches 8 to 15. 


matrix_demo2.py 

> Language: Python 


001. 

002. 

003. 

004. 

005. 

006. 

007. 

008. 

009. 

010 . 

011 . 

012 . 

013. 

014. 

015. 

016. 

017. 

018. 

019. 

020 . 

021 . 

022 . 

023. 

024. 

025. 

026. 

027. 

028. 

029. 

030. 

031. 


import time., os 

os.system("sudo pigpiod") # enable pigpio system 
from max7219bang import Max7219bang 

brightness = 8 

dataPin = 14 ; clockPin = 15 ; loadPin = 18 # matrix wiring 
matrix = Max7219bang(dataPin,clockPin,loadPin, brightness) 

def main() : 

print("Matrix demo - Ctrl C to stop") 

print ("Read switches and light up all LEDs on the pushed one") 
matrix. clrLEDsQ # turn all LEDs off 
while True: 

pressed = matrix. getSwitchQ # return pressed switch or -1 
for none 

if pressed != -1 : # if switch has been pressed 
print ("Switch", pressed, "pressed", end=" ") 
if matrix. getLed(pressed) == 0: # if LEDs off 
matrix. setLed(pressed, 7) # turn them on 

print( lights on") 
else: 

matrix. setLed(pressed,0) # turn them off 
print( lights off") 

# Main program logic: 

if _name_ == '_main_ 1 : 

try: 

main() 

except: 

matrix. cleanUp() 

# Note the use of the code disables any error output from the 
code 

# when developing code comment out the lines:- try: and except: 
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▲ Figure 5 Pressing a switch inverts its column and row 


The class library code 

The code for the < max72i9bang’ class 
library is shown in the max72i9bang.py 
listing; it should be stored in the same folder 
as the programs that use it. You could install it 
permanently into the Python 3 system by altering 
Python’s search path or storing it into a folder 
which is in Python’s path, but we recommend 
that you simply have it in the same folder as 
programs that use it. The first time it is run, a 

_pycache_directory will be created to save the 

semi-compiled version of the class library. This 
makes it run faster. 


Using the class library 

The code in the matrix_demo2.py listing 
shows an example of reading the switches, and 
turning on or off all the LEDs on that switch. 

It shows the use of many of the class library 
functions. One important thing to note is that 
you must enable the pigpio system before loading 
the class library. This is only needed once per 
session and could be done from the command 
line, but we include it in the code for simplicity. 
When a switch is pressed, the state of the LEDs 
is retrieved for that switch, and all the LEDs are 
changed to the opposite state. 


The Lights Out game 

The matrix_lightsOut.py listing is a simple 
Lights Out game. The object is to turn out all the 
LEDs on the matrix board by pressing switches. 
Each switch inverts all the LEDs in the column 
and row of the switch pressed - illustrated in 
Figure 5. The game starts out with a set of lights 
that are on and you have to turn them all out with 
two presses. Once you get down to just needing 
one press, it is obvious where you need to press. 

If you press incorrectly, you can always press the 
same switch again and negate the press. Figure 6 
(overleaf) shows a typical puzzle. 


Customising the Lights Out game 

The call to the setup function determines 
the number of key presses you need to complete 
the game. We found going to three was a bit of a 
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matrixJightsOutpy 

>• Language: Python 


001. import time., os, random 

002. os.system("sudo pigpiod" ) # enable pigpio system 

003. from max7219bang import Max7219bang 

004. 

005. brightness = 8 

006. dataPin = 14 ; clockPin = 15 ; loadPin = 18 # 

matrix wiring 

007. matrix = Max7219bang(dataPin ,clockPin, 
loadPin,brightness) 

008. speed = 0.2 ; random. seed() 

009. 

010. def main( ): 

011. global done 

012. print("Simple lights out game - Ctrl C to stop") 

013. print("Press buttons until all lights are out") 

014. matrix. clrLEDs( ) # turn all LEDs off 

015. while True: 

016. f lash(4) 

017. done = False 

018. emptyPresses( ) # remove any bounce 

019. setup(2) # level of scrambling 

020. print("Try this one then") 

021. while not done: 

022. pressed = matrix. getSwitch( ) # return 

pressed switch or -1 for none 
023. if pressed != -1 : # if switch has been 

pressed 

024. matrix. setLed(pressed, 

matrix. getLed(pressed) A 7) 

025. invertRow(pressed) 

026. invertCol(pressed) 

027. done = checkOutQ 

028. emptyPresses( ) # remove any bounce 

029. 

030. def invertRow(switch) : 

031. row = switch // 4 

032. for i in range ( row*4,row*4+4) : 

033. matrix. setLed(i, matrix. getLed(i) A 7) 

034. time.sleep(speed) 

035. 

036. def invertCol(switch) : 

037. col = switch % 4 

038. for i in range(col, 16,4) : 

039. matrix. setLed(i, matrix.getLed(i) A 7) 

040. time. sleep(speed) 

041. 

042. def checkOutQ: # check LEDs are all off 


043. off = True 

044. for switch in range(0,16): 

045. if matrix. getLed(switch) != 0: 

046. off = False 

047. return off 

048. 

049. def setup(depth) : # inital position of LEDs 
050. global speed 

051. speed = 0.001 # make setup quick 
052. matrix. clrLEDs( ) # turn all LEDs off 
053. for i in range(0, depth): 

054. target = random. randint(0, 15) 

055. #print(target) # uncomment for testing 

056. matrix. setLed(target, 

matrix. getLed(target) A 7) 

057. invertRow(target) 

058. invertCol(target) 

059. speed = 0.2 # normal display speed 

060. 

061. def flash(times) : 

062. state = 7 

063. for flash in range(0, times*2): 

064. for i in range(0,16): 

065. matrix. setLed(i, state) 

066. time. sleep(0. 3) 

067. state A = 7 

068. 

069. def emptyPresses( ): # remove all bounce from key 
switches 

070. while matrix. getSwitchQ != -1: 

071. pass 

072. print("extra bounce") 

073. 

074. # Main program logic: 

075. if _name_ == '_main_ ': 

076. try: 

077. main() 

078. except: 

079. matrix. cleanUp() 

080. # Note the use of the code disables any error 
output from the code 

081. # when developing code comment out the lines:- try: 
and except: 


The Matrix magpi.cc | 61 










Can you 


encourage young 


people to become 



digital creators? 


CoderDojo is a global network of free, volunteer-led, 
project-based programming clubs for young people aged 
7-17. Here they can learn to code, build a website, create 
an app or a game, and explore technology in an informal, 
creative, and social environment. 


Join us at coderdojo.com/volunteer 


In order to run locally we need volunteers like you with 
a wide range of skills. You don’t have to be a coder to 
mentor. Dojos benefit from a mix of mentors providing 
support and encouragement to CoderDojo attendees. 


Dojo champions, who manage each club, 
will be able to discuss how you can best 
support attendees, and we’ll provide you 
with any resources and 
advice you might need. 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 


Part of i 


) Raspberry Pi 






PI BAKERY IMatfPi 



▲ Figure 6 What switch do you have to press 
to get the Figure 5 pattern? 


challenge, but it could be done by trying a key and 
seeing if you could solve the problem as presented 
in the original two-press version. If it couldn’t be 
done, then you press that key again to undo its 
action and try another. Taking this to even more 
levels might be too hard unless you leave a trail of 
breadcrumbs - that is, print out the switches you 
have pressed, when you press one. 


Your turn 

You should now have all the tools you need to 
write your own programs, so here is the challenge 
we promised at the start of this project. Write a 
program to display a user-defined sequence of 
lights on the matrix that you can store and load 
from a file. You should be able to display the 
sequence at any speed, forwards or backwards, 
continuously. We will publish our efforts for this 
program on our GitHub page in two months; good 
luck with yours. ED 


Start with #73 


This is the Latest instalment 
in a series of Mike's Pi Bakery 
tutorials. You can download 
digital editions of previous 
tutorials for free. Start with 
The Mag Pi # 73 . 

magpi.cc/73 



max7219bang.py 


> Language: Python 


001. import time 

002. import pigpio 

003. 

004. class Max7219bang() : 

005. 

006. def _init_ (self , data,clock,load,bright) : 

007. self. da = data 

008. self.ck = clock 

009. self. Id = load 

010. if bright >-l and bright < 16: 

011. self.br = bright 

012. else : 

013. self.br = 8 

014. # copy of the Max chip's registers 

015. self .registers = [0]*9 

016. #0=off,l=red,2=green,4=blue 

017. self .ledsState = [0]*16 # all off 

018. self .ledCol = [0,4, 2,6,1,5,3, 7] # LED colour 

numbers RGB 

019. # colour offset per switch 

020. self .colOff = [0,0, 0,0, 4,4,4,4, 0,0,0,0, 

4,4,4, 4] 

021. # switch number to register address 

022. self. address = [1,3, 5,7, 1,3,5,7, 2,4,6,8, 

2,4,6, 8] 

023. self .buttonPins = [12,25,24,23,6,13,19,26,16,20,21,4, 

17,27,22,5] # rows 

024. self .switches = [False] * 16 

025. 

026. self. pi = pigpio. pi() 

027. if not self .pi.connected: 

028. print ("Pi not connected") 

029. self .pi. set_mode(self .ck,pigpio.OUTPUT) 

030. self .pi. set_mode ( self .da,pigpio.OUTPUT) 

031. self .pi. set_mode( self .Id,pigpio.OUTPUT) 

032. for i in self .buttonPins: 

033. self .pi. set_mode(i, pigpio.INPUT) 

034. self .pi.set_pull_up_down(i, pigpio.PUD_DOWN) 

035. self .pi.write(self.ck, 0) 

036. self .pi.write(self.da, 0) 

037. self .pi.write(self.Id, 1) 

038. 

039. self.cb = [None] *32 

040. for i in range (0, len(self.buttonPins)): 

041. self .pi. set_glitch_filter (self .buttonPins[i], 200) 

# microseconds filter 

042. self.cb[i] = self .pi.callback(self .buttonPins[i], 

pigpio.EITHER_EDGE, self.cbf) 

043. self .sendMax(0x9,0) # no decode 

044. self .sendMax(0xB,7) # scan all digits 

045. self .sendMax(0xA, self .br) # intensity 
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DOWNLOAD 

THE FULL CODE: 



magpi.cc/1NqJjmV 



046. 

self . sendMax(0xC,l) # take out of shutdown 

092. 

mode 


093. 

047. 

self .clrLEDsQ # start with all off 

094. 

048. 

for i in range(0,16): # clear out any glitches 

095. 

049. 

self .switches[i] = False 


050. 


096. 

051. def setBrightness(self, brightness) : 

097. 

052. 

if brightness > 15: 


053. 

brightness = 15 

098. 

054. 

if brightness < 0: 


055. 

brightness = 0 

099. 

056. 

self.br = brightness 

100. 

057. 

self . sendMax(0xA, self.br) 


058. 


101. 

059. def clrLEDs(self ): 


060. 

for add in range(l,9): # all display 

102. 

registers 


061. 

self .registers[add] = 0 

103. 

062. 

self .sendMax(add,0) 


063. 

for i in range(0,16): # all display leds 

104. 

064. 

self .ledsState[i] = 0 

105. 

065. 


106. 

066. 

getLed(self, switch) : 

107. 

067. 

return self .ledCol[ self .ledsState[switch]] 

108. 

068. 


109. 

069. 

setRed(self, switch) : 

110. 

070. 

self .setLed (switch,1) 

111. 

071. 

setGreen(self , switch) : 

112. 

072. 

self .setLed (switch,2) 

113. 

073. 

setBlue(self, switch) : 

114. 

074. 

self .setLed (switch,4) 


075. 


115. 

076. 

addRed(self, switch) : 


077. 

col = self .getLed(switch) | 1 # add red 

116. 

078. 

self .setLed (switch,col) 

117. 

079. 

addGreen(self , switch) : 

118. 

080. 

col = self .getLed(switch) | 2 # add green 


081. 

self .setLed (switch,col) 

119. 

082. 

addBlue(self, switch) : 

120. 

083. 

col = self .getLed(switch) | 4 # add blue 

121. 

084. 

self . setLed (switch,col) 

122. 

085. 


123. 

086. 


124. 

087. 

setLed(self, switch, col) : # set what LEDs are 


on for : 

switch 

125. 

088. 

if switch > 15 or switch < 0 : 


089. 

switch = 0 #default for switch 

126. 

out of 

range 

127. 

090. 

col &= 0x7 # restrict to 0 to 7 


091. 

col = self .ledCol[col] #convert to register 

128. 

data 


129. 


self .ledsState[switch] = col 
reg = self .address[switch] 
if self .colOff[switch] == 0 : 

self .registers[neg] = (self .ledsState[ 
switch] << 4) | (self .ledsState[switch+4]) 
else: 

self .registers[reg] = (self .ledsState[ 
switch-4] << 4) | (self .ledsState[switch]) 
self . sendMax( self .address[switch], 
self .registers[reg]) 

def cbf(self, gpio, level, tick): # call back 
function 

place = [i for i,x in enumerate( 
self .buttonPins) if x == gpio] 

#print("GPIO",gpio,"switch",place[0], 

"steady level",level) 

self .switches[place[0]] = True # indicate 
switch has changed 

def getSwitch(self ): 

pressed = -1 ; i = 0 

while pressed == -1 and i<16: 

if self .switches[i]: # key press found 
self .switches[i] = False 
pressed = i 
i+=l 

return pressed 

def sendMax(self, add,data) : # send a byte to mux 

chip 

package = (add << 8) | data # join into one 
bit pattern 

self .pi.write(self.Id, 0) # lower load 
for i in range(15, -1, -1) : # from 15 to 0 

self .pi.write(self.da, 1 & (package » i)) 
# send MSB first 

self .pi.write(self.ck, 1) # toggel clock 
self .pi.write(self.ck, 0) 
self .pi.write(self.Id, 1) # latch value 


def cleanl)p(self ): 
self .sendMax(0xC,0) 


# put into shutdown 


mode 


for i in range (0, 16): # remove callback 

vectors 

self .cb[i] .cancelQ 
self .pi. set_glitch_filter ( 
self .buttonPins[i], 0) 

self .pi.stop() # stop pigpio 
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McitfPi RASPBERRY PI 3A+ 


Raspberry Pi 



□ Packing the power of the 
3B+ into the same footprint 
as the original Pi A+ □ 


Gone too long, the A+ is back with 
the power of the Pi 3 behind it 


T he last time the Raspberry Pi family had a 
new A-form-factor design, more compact 
and lightweight than the full-size B and 
B+ ranges, it was the Raspberry Pi A+ released 
four years ago. Since then, the family has grown 
considerably: we’ve seen the Pi 2, Pi 3, Pi Zero, Pi 
Zero W and WH, and most recently the 3B+. 


Now, the Raspberry Pi 3A+ is here, packing the 
power of the 3B+ into the same footprint as the 
original Pi A+. Read on for the lowdown on what 
Eben Upton describes as “the best product we 
can make.” 


suppliers: 


The Pi Hut 

magpi.cc/zVTpyC 


PIMORONI 

Tech Treasure for Tlnkerers 

Pimoroni 

magpi.cc/LhuKdS 
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CPC 

magpi.cc/algkOF 


IMODMYPII 


ModMyPi 

magpi.cc/rMXCsW 


Bl 

RS Components 

magpi.cc/nDkZGZ 


Fora complete list of 
resellers globally where the 
new Raspberry Pi 3 Model 
A+ can be purchased, 
please see rpf.io/products 
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Meet the Raspberry Pi 3A+ 

The 3A+ squeezes a lot into its compact footprint 


SPECS 


SoC: 

Broadcom 
BCM2837B0 
quad-core A54 
(ARMv8) 64-bit 
@ 1.4GHz 


GPU: 

Broadcom 
VideoCore IV 


NETWORKING: 

2.4GHz and 5GHz 
802.nb/g/n/ac 
wireless LAN 


RAM: 

512MB LPDDR2 
SDRAM 


BLUETOOTH: 

Bluetooth 4-2, 
Bluetooth Low 
Energy (BLE) 


GPIO: 

40-pin GPIO 

header, 

populated 


STORAGE: 

microSD 


PORTS: 

HDMI, 3.5mm 
analogue audio¬ 
videojack, 

1 x USB 2.0, 
Camera Serial 
Interface (CSI), 
Display Serial 
Interface (DSI) 


DIMENSIONS: 

67*56x11.5 mm 



A The radio, originally developed 
for the 3B+, makes the 3A+ 
the first A-model to feature 
on-board networking 



QuickStart guide 

The Raspberry Pi 3A+ is directly compatible with 
the 3B+ and all other Raspberry Pi models. If you’ve 
already got a power supply and microSD card with 
a new version of Raspbian installed (grab the latest 
image from rpf.io/downloads), you’re ready to go. 
If the 3A+ is your first Raspberry Pi, see our online 
QuickStart guide to get up and running fast, 
magpi.cc/quickstart 


▼ Full-size display (DSI) and 
camera (CSI) ports make 
connecting peripherals a snap 



A The 3A+ benefits from 
the same clever power 
management chip (PMIC) 
as the 3B+ 



A Unlike the Zero family, the 
3A+ includes both full-size 
HDMI and analogue audio¬ 
video outputs 
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BROADCOM 


BCM2837B0IFSBG 
TA1801 P20 
176-01 N2 W 


i; a a 


a PWR- !N 


^ The 3A+ has the same 
1.4GHz system-on-chip 
(SoC) as the 3B+, with no 
Loss of performance 


► The biggest change from 
the 3B+: the reduction from 
four to one USB 2.0 ports 
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Benchmarking 

the Raspberry Pi 3A+ 


Small but mighty, the reduction 
in size doesn’t mean the 3A+ 
costs you any performance 
over its bulkier brother 


F or projects where a full- 
size Pi 3B+ is simply too 
bulky, there hasn’t been 
much choice: aside from the 
Compute Module 3, which is 
targeted at industrial users, the 
choices were the four-year- 
old Pi A+ or ultra-compact Pi 
Zero family - and in either 
case it meant a dramatic drop 
in performance. 

The Pi 3A+ comes with the 
promise of full-size performance 
in a small, lightweight, and less 


power-hungry package, but the 
only way to see if that is true or 
not is to put it through its paces 
in a range of benchmarks. 

Spec comparison 

At its heart, the Pi 3A+ is literally 
a cut-down version of the Pi 
3B+. It has the same Broadcom 
BCM2837B0 system-on-chip 
(SoC) roughly in the centre of 
the board, hidden under a metal 
heat-spreader, which runs at the 


same 1.4GHz frequency. While 
512MB of RAM is less than the 
lGB of a Pi 3B+, the smaller 3A+ 
can certainly hold its own. 

Looking back at the original Pi 
A+, it’s hard to imagine they’re 
from the same family: from 
a single-core 32-bit 700MHz 
processor and no networking 
to a quad-core 64-bit 1.4GHz 
processor with built-in wireless 
LAN and Bluetooth, the 3A+ 
should prove a serious upgrade 
for users of its predecessor. 


Python GPIO 

Higher is better 

Designed to highlight a real- 
world bottleneck, the Python 
GPIO benchmark switches a 
single pin on and off while a 
frequency counter measures 
how quickly the pin is toggled. 
The faster a Pi's processor, the 
faster the pin can be toggled 
before the processor hits its limit. 




SysBench CPU 

Lower is better 

Designed to focus on the central 
processor’s performance, the 
SysBench CPU benchmark tests 
how quickly a Pi can perform prime 
number calculations. For Pi models 
with quad-core processors, the 
test is run twice: once with a single 
thread using only one of the cores, 
and again with four threads using 
all four cores. 



343.06 


336.91 



337.02 


339.21 



SINGLE-THREADED (SECS) 
MULTI-THREADED (SECS) 


218.53 



139.22 


34.97 

119.22 119.23 


30.04 


29.92 







Model A Model B Zero Zero W Model A+ Model B+ Pi 2 Pi 3 Pi 3B+ Pi 3A+ 
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SysBench 

Memory Throughput 

Higher is better 

Processor performance is only part 
of the puzzle when it comes to 
overall system performance: in the 
SysBench Memory Throughput test, 
measurements are taken to show 
how quickly a Pi can read and write 
to the random-access memory 
(RAM) in lkB chunks, reported in 
megabytes per second (MBps). 



lkB READS (MBps) 
lkB WRITES (MBps) 


120.12 

108 


89.43 


Model A Model B 


99.97 


147.27 


106.9 


Zero 


857.96 856.48 


719.76 



139.01 


Zero W Model A+ Model B+ Pi 2 Pi 3 Pi 3B+ Pi 3A+ 


Power Draw 

Lower is better 

More performance typically means 
more power used, and here each Pi is 
connected to an HDMI display, wireless 
keyboard, and, where applicable, a 
WiFi or wired Ethernet network before 
two measurements are taken: the 
power used, in watts, while the Pi is sat 
idle at the desktop, and again while 
running a CPU-heavy application. 




Thermal 

Performance 

Cooler is better 

The Pi 3B+ benefited from 
a change to the way the 
system-on-chip (SoC) is 
attached to the circuit board, 
allowing it to better dissipate 
heat. With the 3A+ having 
a smaller board, this test 
captures thermal images 
under heavy CPU load to 
show how well the two 
designs cope. 




Size & Weight 

Lower is better 

The biggest difference between the Pi 3B+ 
and the 3A+ is their respective sizes. Here, 
the footprint of each Pi model is measured 
from its widest points - to include the size of 
the ports which sit proud of the board - and 
its weight measured, both important aspects 
for embedded and robotics applications. 

FOOTPRINT (mm 2 ) 
j WEIGHT (g) 

5904 5904 




5083 5083 5083 5083 50 
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McitfPi RASPBERRY PI 3A+ 


Eben Upton and 
Roger Thornton 
on the Pi 3 A+ 

Eben and Roger talk about the Pi 3 A+'s inspiration, 
launch timing, and hint at the Raspberry Pi 4 

i i 

i i 

! Simplifying certification 


fflAI e describe our product design 
UU process as resembling a bunch 
W W of trains driving along, because 
we’re dealing with a bunch of subsystems,” Eben 
Upton, co-founder of the Raspberry Pi Foundation, 
explains of the development process that has 
delivered the Raspberry Pi 3 Model A+. “Some 
subset of the trains will arrive at the station, and 
when enough of them arrive then we’ve got a new 
product we can make. We don’t have a big team of 
marketing guys who make PowerPoints about our 
roadmap. It’s much more coffee-table-oriented 
than that.” 

Bringing back the A+ 


"What’s the cost to do a certification 
campaign,” Eben asks. “Couple of 
hundred thousand?" 

“For a five-gig one, yeah, it’s about 
250... 300000," answers Roger - the cost 
of clearing a radio-containing product 
like the Raspberry Pi 3 for general sale. 

The Pi 3B+ moved to a modular radio 
certification, meaning that the existing 
compliance work remains Largely valid 
for the 3A+ “A Lot of the work we’d done 
to modularise the board meant that we 
could copy over pretty much all of our 
compliance work," Roger explains, “so 
thankfully this product’s been just a bit 
of paperwork. There’s definitely been an 
improvement in time-to-market." 



▼ As with any Raspberry Pi, 
the 3A+ undergoes in-depth 
testing before it’s released 
to the public 


“The A+ form factor was always a good form 
factor,” says Roger Thornton, Principal Hardware 
Engineer. “A lot of people have asked us for an A+ 
again, and we were able to make that, so we did.” 

With both the Raspberry Pi 2 and 3 having 
launched exclusively in larger B-variant form 
factors, the A+ has been absent from the line-up 
for a full two generations. “It was skipped for 
Raspberry Pi 2 because it simply wasn’t around 
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“4 "If we have an 

opportunity to bring 
our best tech down 
a bit then we do,” 
explains Eben Upton 


H "A Lot of people have 
asked us for an A+ 
again, and we were 
abLe to make that,” 
says Roger Thornton 
of the launch 


for long enough,” recalls Eben. “It normally takes 
six to nine months for us to get our feet under 
ourselves, and by that time it was very clear that 
the 3B was imminent. ” 

“The Zero W happened the year after the 3B,” 
Roger adds, “and to some extent addressed the gap 
that an A+ might have occupied.” 

The Zero family isn’t a complete replacement for 
the A+, though, as the launch of the Pi 3B+ earlier 
this year hammered home. 



“We're confident that the performance you saw 
on a 3B+ you’U be able to get on a 3A+" says 
Roger. “There's no reduction because of the 
board size change; you should still be able to 
run the processor at the same speed. We have 
had to reduce the memory to hit the price point 
we’re after, but it still runs nicely.” 

“When we launched the original A+, we 
Launched it with half the RAM of the original B+," 
Eben adds. “At the time that meant 256MB; now 
halving the RAM still leaves you with half a gig, 
which is kind of fun." 


Filling a hole 

“There’s a massive performance gulf between the 
3B+ and Zero,” explains Eben. “3A+ represents us 
bringing our best technology to the lowest possible 
price point. We can’t bring this technology down 
to the Zero price point, at the moment, but we can 
bring it down a bit. 

“We don’t just like to sit there at $35 feeling 
pleased with ourselves. If we have an opportunity 
to bring our best tech down a bit, then we do. I 

□ This is us bringing our best 
technology to the lowest 
possible price point □ 

mean, this is the best product we can make. We 
don’t know how to make anything better at the 
moment. It’s lovely, actually. We like to make 
physically beautiful objects. They sometimes cost a 
bit of money to make, or cost a bit of blood, I think, 
and this... I mean, for me, once we knew we could 
make it, I think we kind of had to. 

“There maybe another motivation for doing 
it: it’s kind of tidying up ‘classic’ Raspberry 
Pi,” Eben admits. “We’re not about to launch 
a Raspberry Pi 4, but our attention is turning 
to what might go into a Raspberry Pi 4; we’re 
starting the research phase of figuring out what 
we might do next. Tying up loose ends is an 
important part of that, and the lack of an A+ 
form-factor product is a loose end.” ED 
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RASPBERRY PI 


PROJECTS BOOK 

VOLUME 4 

Amazing hacking and making projects 

from the makers of mm magazine 

Inside: 

# How to get involved with the Pi community 

# The most inspirational community projects 

• Essential tutorials, guides, and ideas 
# Expert reviews and buying advice 

magpi.cc/store 

plus all good newsagents and: 

WHSmith BARNES&NOBLE 



Available on the GET IT ON 
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McitfPi I REVIEW 


GFX HAT 


► Pimoroni ► magpi.cc/ZWvcLG ► £20/$25 

Rob Zwetsloot looks at a slightly simpler, but much 
more practical, Raspberry Pi display from Pimoroni 


W e get asked a lot on The MagPi about 
practical projects - in essence, builds 
that are less experimental party 
pieces, and something you can use day-to-day to 
automate or improve your life in some way. There 
are plenty of fun Raspberry Pi products you can get 
for creating fun stuff, but there are also the lesser- 
known add-ons which can truly help you make a 
more useful project. 

This is the sort of category we see the GFX 
HAT sitting in. That’s definitely not a bad thing, 
though, and if you fancy using it to make a Dalek 
or a tweeting cat flap, we’re definitely not going 
to stop you. However, the functionality of the GFX 


HAT makes it perfect for using it in the kind of 
low-power, headless Raspberry Pi solution that 
takes up little space. 

Useful functionality 

What makes the GFX HAT so good for practical 
projects is that it contains a monochrome, 128x64 
display and six capacitive touch buttons. While 
the display is very simple compared to modern Pi 
display HATs, it does mean it’s easier to program 
custom interfaces, while still having very basic 
options for readable text and number displays. 

The buttons hook straight into Python, allowing 
you to control the Pi and the display. They have 


DISPLAY SIZE: 

2.15 inches 

DISPLAY 

RESOLUTION: 

128x64 

monochrome 

INPUT: 

6 x capacitive 
touch buttons 

CODING: 

Programmable 
in Python 

COMPATIBILITY: 

All 40-pin GPIO 
Pi boards 


► ALL the info you need is 
on the back, aLthough 
you can't see that 
when it's on the Pi 


m 




mm 

Made in Sheffield, UK 
http://plmoroni.com 



/# H. If ft f? If. ft p 

UtlUUUUliliUUUUUUUUiiii 

Get started: http://pimoroni.com/gfxhat 

Backlight: SN3218 l 2 CAddr:0x54 
Buttons: CAP1166 l 2 CAddr:0x2C 

l°J JZ 

A 2.15” 128x64 pixel v iifcA . 

monochrome LCD. ; 0 #= = ° 

6 capacitive toucho - = = 

buttons complete I ' «'«•' ( ° v 
with indicator LEDs. 


mi 
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Small and sLeek, much 
like the current range 
of Pimoroni HATs 


some basic symbols on them which 
you can use, or you could just ignore 
and relabel them if you really fancy. 

If this all sounds slightly familiar, then 
you may remember an early Pimoroni product 
called the Display-O-Tron, which had a few 
buttons and a scrolling display. The GFX HAT is the 
evolution of this concept, which we regularly used 
at home in practical projects ourselves. 

Programmable and hackable 

As with a lot of Pimoroni products, a custom 
Python library is available for the GFX HAT. With 


it, you can control the individual 
pixels on the screen, the colour 
of the backlight, the backlight on the 
touch buttons, or just input some text for 
it to display. 

□ The programmable backlights 
really make this something 
else as well □ 



It’s not quite as straightforward as GPIO Zero, 
because it's a fair bit more complex than just 
lighting an LED; however, with the provided 
examples and some testing, you’ll quickly be able 
to figure out how to work it. 

The programmable backlights really make 
this something else as well - to get visual 
feedback from your press on the buttons from a 
UX perspective - and really opens the doors to 
the kind of projects you could use it for. Simon 
game, anyone? 

We also think it works great, with quick 
responses, and a very smart look when you use the 
right case. Hopefully it will prove useful in your 
next Raspberry Pi project. ED 


Verdict 


A great upgrade 
over the older 
Display-O-Tron, 
the GFX HAT is 
very customisable 
for use in many 
practical Pi 
projects. 

9/io 
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► A Pi Zero (or other model) can 
be secureLy mounted on the 
rear - we Love the amusing 
illustrations, too 


Ubercorn 

► Pimoroni ► magpi.cc/eebBWo ► £45/$49 



While bigger doesn't always mean better, this super-sized display HAT dazzles Phil King 


D warfing the Unicorn HAT HD, the Ubercorn 
is even bigger than we anticipated. It 
comes pre-assembled, so you can just plug 
a Pi Zero into the female GPIO header on the rear, 
or use the supplied header extension and metal 
stand-offs to raise the Ubercorn above the USB 
ports on a larger Pi model. 

Since it is essentially a super-sized version 
of the Unicorn HAT HD i6 x i6 matrix display, 
you can make use of the latter’s Python library 


▼ Measuring 19cm square, the Ubercorn's 
16x16 RGB LED matrix can produce 
impressive visual displays 



(magpi.cc/EETRAi) to program it, including 
functions to set individual pixels and scroll text. 
Standard RGB LEDs are used, so they can be 
controlled individually, making the Ubercorn 

□ The graphical effects look 
much better when diffused, 
increasing the perceived 
size of the pixels □ 

suitable for animations. Several code examples 
are supplied, including a rainbow, graphical 
effects demo, and slideshow of sprite PNGs. 

Blurred lines 

The graphical effects look much better when 
diffused, increasing the perceived size of the 
5 mm pixels. While no diffuser is supplied, you can 
make your own with frosted Perspex or even blank 
pieces of white paper. 

As the Ubercorn draws around 1A of current, 
a connected Pi will easily power it. If you want 
to daisy-chain (up to eight) Ubercorns using the 
eight-pin data in/out headers, however, you’ll 
need to power them via their screw terminals. 

As the current flow is limited by three on-board 
560 D resistors to avoid overheating, the display 
is a little dim in daylight - particularly when 
diffused - at the default 0.5 brightness, but turn 
it up to max and it’s plenty bright enough. EH 


SPECS 


DIMENSIONS: 

19x19 cm 

PIXELS: 

256 (16x16) 

RGB LEDs 

DRIVER CHIP: 

ARM STM32F 

INTERFACE: 

SPI 


Verdict 


Easy to program, 
the Ubercorn is a 
super-impressive 
Large display. 
Potential projects 
include a weather 
display, loT 
dashboard, and 
'Game Frame' (see 
magpi.cc/nbHkow 
for an example). 

9/io 
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Code Design 


File Edit Tools Window Help 




Now free for home projects 

A professional control system 
development tool 


CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a Large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 

Free download on www.cdpstudio.com 


CDP Technologies AS 
Nedre Strandgate 29 
P.O. Box 144 

NO-6001 Alesund, Norway 



Tel: +47 990 80 900 
infcxacdptech.com 
www.cdpstudio.com 


CDPEjfudio 




















































Mufti I REVIEW 


10 Best: 


Raspberry Pi 
Christmas gifts 

Fill some stockings with 
these Pi-powered presents 


A s this issue comes out at the start of 

December, hopefully this little list arrives 
just in time to help you get something for 
the maker in your life. From all of us at TheMagPi, 
have a Merry Christmas and a Happy Holiday! ED 


Mood Light 

TYPE: Fun little light project 


This perfect stocking-sized gift 
is part of the excellent range of 
Pimoroni Pi Zero W project kits. 
Keep it by your bed or in your 
Lounge and use it to show off 
your big moods with this highly 
customisable build. 


► £30 / $33 

► magpi.cc/xqySvs 




Christmas 

Tree Star 


TYPE: Pi Zero tree star 


This Pi Zero HAT is also a star you 
can attach to your tree! Upgrading 
your decorations with a Raspberry 
Pi is always cool You’Ll need to 
make sure you have a very Long USB 
power cable, though. 

► £13/$17 « 

► magpi.cc/woQGiF 



SnowPi 


3D Xmas Tree 

TYPE: Three-dimensional 
light-up kit 


Although there are a few 
Christmas tree kits available for 
the Raspberry Pi, none of them is 
three-dimensional Like this one! 

It comes in soLder-yourseLf and 
pre-soLdered versions.. 

► £15 / $19 

► magpi.cc/2GewFwe 


an i in ii in 



mis HI ill !P* 


jam 



Christmas Tree 

Solder Kit 

TYPE: For makers or programmers 


There are two versions of this kit: the 
one for makers which you just need 
to solder together and run, and the 
version for programmers that you 
can build and then hack and modify. 
Choices, choices. 


TYPE: The GPIO snowman 


We Love this classic project kit, so 
we're more than happy to bring 
it back for this year’s Christmas 
guide. It fits on top of a Raspberry 
Pi, and comes as an adorable Little 
kit that’s perfect for practising 
a bit of soldering and coding on 
Christmas Day. 

► £ 6/$8 

► magpi.cc/2GdupFA 


► £6 / $8 

► magpi.cc/efhJHh 
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InsPiRing 

TYPE: Customisable light arrays 


Want to build the ultimate Christmas 
light display? Look no further 
than the RasPiO InsPiRing range 
for creating weird and wonderful 
shapes that are sure to make the 
neighbours jealous. 

► £10/ $13 

► rasp.io/inspiring 


OctoCam 

TYPE: Stick to the camera 


This cute little kit includes a tiny 
5MP camera. You can stick its 
suckers to any window for a peek 
outside, or - using the supplied 
desk stand - put it on a shelf to 
keep an eye on your all-important 
gifts under the tree. 

► £40/$43 

► magpi.cc/RqFLZW 




The Official 
Raspberry Pi 
Projects Book 

Volume 4 

TYPE: Handy book of projects 


Knowledge is power, and our latest 
Projects Book has 200 pages of 
projects and tutorials to inspire 
and guide you in your journey to 
becoming a maker. It also slots 
nicely into a stocking. 


► £13/ $17 

► magpi.cc/projects4 




YetiBorg v2 

TYPE: The ultimate tiny robot 


This tiny robot kit can just about 
squeeze into a stocking, and is the 
ultimate little toy to play around 
with on Christmas Day - after some 
adult-supervised building, that is. 
Once you're done playing around 
with it, you can start hacking it to do 
even more. 

► £160/$218 

► magpi.cc/TADbiy 


Raspberry Pi 

Swag 

TYPE: Stuff for fans 


Pins, bears, mugs, stickers, and 
coasters for the Raspberry Pi fan in 
your life. And the best part is, any 
profits go straight to the Raspberry 
Pi's charitable mission! We 
especially like the enamel badges; 
they're very smart. 

► Various 

► rpf.io/swag 



CHRISTMAS PROJECTS 


I Have a Christmas project you’d like to show us? 
Make sure to tag us in social media posts (Twitter 

@TheMagPi and Facebook TheMagPiMagazine) 

and maybe you’ll be featured next issue... 
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learn to 


Scratch is the perfect first programming language. 
Sean McManus rounds up some of the best resources 


I 


Learn to Code with Scratch 


Learn Scratch 

with Raspberry Pi 


with 

\SCRATCH 

GAMES ^ ^'cations 

vow, ItaApberru Vi 

V-.'ii 



The MagPi Team 


Price: 

£4 / $5 (free download) 

magpi.cc/ 

learnscratch 


Our own Essentials book brings 
together some of our best 
Scratch articles, with content 
that’s exclusive to this book. 
Chapters are typically three 
or four pages, and each one 
explains a separate project. 

Following an introduction 
to making your first Scratch 
program, there are chapters 
on creating games called 
Bouncy Hedgehog (a catching 


game), Boat Race (a steering 
game), and a multiple-choice 
quiz. Non-game projects 
include a simple chatbot you 
can extend, a poetry generator, 
and LED traffic lights. The 
traffic lights use the Raspberry 
Pi’s GPIO pins and components 
from the Camjam EduKit #1 
(available separately). 

There are two chapters to 
help you customise your own 


Scratch games: one shows you 
how to add a title screen to your 
game to give it a professional 
feel, and the other shows you 
how to add a high-score table 
to keep players coming back 
for more. 

The book builds up to a 
ten-page project to build a 3D 
space shooter and concludes 
with a reference guide to the 
Scratch blocks. 1 3 


Scratch Books 


Learn Scratch with these books 


COOL SCRATCH PROJECTS 
IN EASY STEPS 

Covering both Scratch 1.4 and Scratch 
2.0, this book includes anaglyph glasses 
for eye-popping 3D effects, music and art 
projects, maze games, and a Raspberry Pi 
stop-motion movie creator. 

► magpi.cc/rFxcha 

LIFELONG 

KINDERGARTEN 

Explore the educational philosophy 
behind Scratch’s design with this book 


by Mitchel Resnick, who leads the Scratch 
development team. Includes tips for 
teaching with Scratch. 

► magpi.cc/XkAYXE 

SUPER SCRATCH 
PROGRAMMING ADVENTURE 

A fun comic strip links the nine projects 
in this book, which gradually build your 
Scratch skills. Games include a soccer 
game, side-scrolling racing game, 
and a combat game. 

► nostarch.com/scratchl 
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ScratchEd 


Lifelong 
Kindergarten, 
OHO Interactive 

Price: 

Free 

I magpi.cc/vTfPtH 


ScratchEd is a community for 
teachers and other educators 
using Scratch, created by the 
team behind Scratch itself. At 
the heart of the site is a directory 
of Scratch resources, making it a 
great destination for learners too. 

The resources are organised 
by education level, content type, 
curricular area, and language. 
The curricular areas include 
engineering, maths, music, 
visual arts, and social studies. 

At the time of writing, there 



YouTube 

Videos 


are 603 English resources, so 
it’s a great place to go if you’re 
looking for inspiration, tutorials, 
or lesson plans. 

ScratchEd has a forum too, 
although it is a bit quiet there. 

If you’re looking for help with 
scripts or other issues unrelated 
to teaching, try the much 
busier main Scratch forum first 
(magpi.cc/kucJpY). EH 




I Scratch Coding Cards 


Natalie Rusk, 
Lifelong 
Kindergarten 
Group, MIT 

Price: 

£20 / $25 
(free download) 

nostarch.com/ 

I scratchcards 


This pack of 75 cards for Scratch 
2.0 is ideal for younger readers 
who might feel overwhelmed 
by a book. The cards break 
some simple projects down into 
easy-to-follow steps. Each card 
contains instructions for adding 
one feature to the program with 
a short script. 

The games included are 
Pong, a catching game, and a 
multiplayer race game. The cards 


go beyond games, though, to 
cover fashion (with a dress-up 
project), music, dance, a virtual 
pet, and storytelling. While 
some projects require readers to 
follow the cards in the correct 
order like a book, others give you 
the freedom to use the cards in 
any order. 

High-quality cards are 
available to buy in a box from 
No Starch, or you can print your 

own (magpi.cc/vkRjlA). EH 



Discover Scratch 
1,4 tips and tricks 

SCRATCH MINI 
TUTORIALS 

Chris Pautler provides short 
videos on topics such as 
keeping score, keyboard 
inputs, and using text 
the player types in. Well¬ 
paced, bite-size chunks of 
Scratch goodness. 

► magpi.cc/mmOWUn 


"" Scratch Tutorial: Ask and wan bk 


r Scratch Tutorial: Making aqUz with buttons 


■ Scratch Tutorial M. 


m Scratch Tutorial: Sprite Rotal’on'Cfcawng directions 


MAKE A PLATFORM GAME 

This six-minute video walks 
you through creating a 
platform game. It doesn't 
get into level design and 
characters, but it does show 
you how to simulate gravity 
and momentum. 

► magpi.cc/WxzDCa 


MAKE TWO-PLAYER PONG 

Discover how to make a Pong 
game with two paddles, a 
bouncing ball, and a scoring 
system. This twelve-minute 
video is well-explained so you 
can easily follow along. 

► magpi.cc/OkEszB 
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MatfPi I INTERVIEW 



Randy 

Lynn 

Helping kids learn to code in Mississippi 


> Category Educator > Website kidscodems.org 

> Day job Partner and creative director, MWB > Twitter @RandylnMS 


J J ■ first developed an 

interest for computing 
I in the 1980s after my 
mother purchased an Apple He 
computer for our family/’ Randy 
Lynn explains to us. His story 
isn’t too different from all the 
kids that grew up with a BBC 
Micro in the UK. “I learned BASIC 
language programming on that 
computer and had lots of fun 
writing simple programs.” 


Unlike some other stories, 
Randy’s experience of learning 
programming at college didn’t 
go so well. 

“I quickly realised that I 
was in over my head,” says 
Randy. “I remember one of my 
instructors telling me that my 
code looked like spaghetti due to 
all the unnecessary branching... 
It probably didn’t help that I 
had joined a punk rock band 


and was spending my weekends 
playing gigs instead of studying 
and learning to write better 
code. Eventually, I decided 
to change my major to focus 
on advertising.” 

It wasn’t until 2013 that 
Randy came back to coding, 
introducing his kids to Scratch, 
and reintroducing himself to 
programming. He went on to 
help their school participate 
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in Code.org’s Hour of Code 
and, since then, has been a full 
advocate of computer science in 
schools, helping to co-found Kids 
Code Mississippi. 

What is Kids Code Mississippi? 

Kids Code Mississippi is an 
advocacy campaign that I co¬ 
founded with the president of my 
agency, Tim Mask. We devote our 
time to the initiative pro bono 
because we believe computer 


the steering committee. Most 
recently, I joined Mississippi’s 
board for ECEP (Expanding 
Computing Education Pathways), 
a coalition of states working 
together to broaden participation 
in computing with a focus on 
equity and diversity. 

What is your history with 
the Raspberry Pi? 

I first became familiar with 
Raspberry Pi computers when my 


□ A young Mississippion today could 
change the world in a similar way 
[to Elvis] with a Raspberry Pi □ 


science education is vital to 
modernising our state’s economy 
and making our workforce 
more competitive. 

We’ve led several hackathons, 
teacher workshops, and 
policymaker forums over the 
past few years. I’ve also set up 
Raspberry Pi stations at events, 
where kids can try out Scratch, 
Sonic Pi, and the Minecraft Pi 
Edition. The kids have a great 
time, and it’s a joy to see their 
eyes light up when taking their 
first steps with coding. 

I’ve also remained involved in 
the CS4MS pilot, helping review 
the curriculum and serving on 


son signed up to represent his 
school in a Technology Student 
Association (TSA) competition. 
His team’s idea involved a video 
display, animated characters, 
sound, button switches, and 
LEDs. I ordered a Raspberry Pi 
online, and it was the perfect tool 
for the job and a lot of fun for the 
team to use, too. 

In 2017 ,1 was at a CS education 
conference and happened to 
strike up a conversation with 
Matt Richardson, Raspberry 
Pi’s Executive Director of North 
America, where I learned about 
the Raspberry Pi Foundation’s 
Picademy training. I attended the 


Atlanta Picademy in 2018, and 
returned home with lots of ideas 
for holding local events. 

What are your future plans? 

I see Raspberry Pi computers as 
a game-changer for education 
in our state. 

Mississippi has struggled, for 
decades, with issues like poverty 
and poor education outcomes. 
Despite some improvements, 
we still rank as the poorest 
state in the US and have the 
lowest rates of both computer 
ownership and access to 
broadband internet. But, at the 
same time, we Mississippians 
are known for our creativity. 
Where in the past, Mississippians 
like Elvis and Muddy Waters 
picked up a guitar at a young age 
and found inspiration, a young 
Mississippian today could change 
the world in a similar way with a 
Raspberry Pi. 

Raspberry Pi’s low price point 
means school districts can add 
a lot of computing power at a 
very low cost, which is critical 
for those areas where the needs 
are greatest. The computers are 
not only perfect for teaching kids 
how to code, but educators can 
incorporate physical computing 
projects into the curriculum, 
too, thanks to the GPIO pins. 

I believe we are ripe for a 
‘Raspberry Revolution’. E 1 


December: 

Computer 

Education 

Month 


Last year, Kids 
Code Mississippi 
managed to bring 
their campaign to 
the Governor of the 
state, who was able 
to institute December 
(this month!) as 
'Mississippi Computer 
Science Education 
Month’. You can join 
in wherever you Live, 
though. Read more 
about it here: 
magpi.cc/xgqjUR 
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This Month 

in Raspberry Pi 



Halloween 2018 


This Pi Zero ‘Scary Halloween Ghost’ has a motion 
sensor to detect when someone is going by so that 
it can Light up and shake and scare them. There are 
also fuLL buiLd instructions for it! 

magpi.cc/WPLGnW 


The Raspberry Pi community gets spooky for October 


A lthough this is the December edition of 

TheMagPi, due to our schedule, Halloween 
occurred while we were writing this issue. 
Halloween is a great time in the community, 
as folks show off their scary projects and 
spooky builds. 

Here are some of the best ones we saw! 

Feel like we overlooked yours? Drop us a line 

at magpi@raspberrypi.org! EH 


A fun skuLL project we 
got sent on Twitter - 
this one plays a Little 
Halloween message 
at the touch of the 
button. Hear what it 
has to say at the Link... 
magpi.cc/ZyXwNe 


Halloween has 
become popular 
in the Netherlands, 
according to maker 
Jaap Meihers: “Houses 
where candy is given out 
are decorated. It’s not 
a competition (yet), but 
if it were, this year our 
house wouLd have won. 
Using a projector and 
a Raspberry Pi running 
media player OSMC, 
we made it Look Like 
zombies were walking 
around in our house." 
magpi.cc/gdAbxa 
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European 
Astro Pi 


Challenge 

update 


Mission Space Lab: Phase One, complete 


L isten up, cadets. We’re pleased 
to tell you that the first phase 
of Mission Space Lab was a 
complete success. Here’s a note from 
Astro Pi command: 

“ESA Education and the Raspberry 
Pi Foundation are delighted to 
announce that Phase 2 of the 
European Astro Pi Challenge: Mission 
Space Lab has begun. During Phase l, 
we received a record-breaking 471 


Camera Modules, and the Sense 
HAT. You all have until 6 February 
to complete your experiments. 

A new mission 

Well done, cadets! For those who 
missed out, we have a new mission 
for you: Mission Zero. Here’s Astro Pi 
command with further details: 

“Young people up to the age of 
14 still have to the opportunity to 


□ Young people up to the age of 14 still 
have to the opportunity to take part □ 


entries from 24 countries! Now, the 
378 selected teams will have the 
chance to write computer programs 
for the scientific experiments 
they want to send to the Astro Pi 
computers aboard the International 
Space Station (ISS). ” 

The selected teams will receive 
an European Astro Pi Challenge kit 
so that they can develop and test 
your experiments. The kit includes 
a Raspberry Pi, two Raspberry Pi 


take part in our second challenge, 
Mission Zero. Teams will have until 
20 March 2019 to write a simple 
program to display their personal 
message to the astronauts on 
board. You don’t need any special 
equipment or prior coding skills, 
and all participants that follow the 
guidelines are guaranteed to have 
their programs run in space.” 

Head to the Mission Zero website 
to learn more: magpi.cc/isLMBf. EU 
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School HAB 


success 


Reaching the top 50 highest launches 
in the UK, thanks to Skycademy 


03 



-4fc 





















I t’s not every day we’re told about successful 
HAB launches from schools, but we received an 
email about an incredible launch from Demeter 
House school, an SEN school in North Lincolnshire, 
that managed to break the top 50 highest HAB 
launches in the UK. At the time of writing, they’re 
at 45 (magpi.cc/JkLZJw); however, they were at 43 
when they first made the record of 36542 metres. 

We were lucky enough to get some pictures to 
share of some of the amazing things you see at 
nearly 120000 feet. W 


The payload patiently waits 
for the balloon to be inflated 


A casual take-off gives 
us a great view of the 
English countryside 


Rising above the clouds 
is always amazing 


A crash-landing in a field 
postflight 


Can you get a more iconic 
image from near-space? 


I •] 



THIS MONTH IN RASPBERRY PI I MatfPi 


Crowdfund this! 


Raspberry Pi projects you 
can crowdfund this month 




Fuel, clock and refresh your Raspberry Pi fully 



Pi PowerBoard 


The Pi PowerBoard is a programmable power board 
for the Raspberry Pi. It includes a real-time clock, 12 V 
power input voltage monitor, and is hackable so you 
can set triggers and timings and such. The creator 
made it as he was looking for a similar power adapter 
for his Pi to be used in a car. Now you can get one too. 

► kck.st/2z4LBer 



Rfey? mil Iftarttoara o 131 flste IffegHti 

SfliTKQftTfrffft o Otenntfl ftifffti rn fl 


High resolution 
3D scanner MKII 


This 'affordable 3D scanner’ is being billed as an 
excellent Pi project, as it runs on a Raspberry Pi 3B+. 
3D scanners can be very expensive, so the sub-£300 
price point is actually pretty good for such a product, 
even if you do have to assemble it yourself. 

► kck.st/2pULP2Q 


DINrPlate™ 



• Industrial DIN rail mount 

• Open frame for better airflow 

• Integrated USB strain relief 



www.DINrPlate.com 

















06. Raspberry Jam @ Pi Towers 

n Saturday 8 December 
® 37 Hills Road, Cambridge, UK 

► magpi.cc/xpGiso 

A family-friendly event where everyone is welcome. 
Coding and digital making activities will be provided 
for participants. 

07. Manchester Raspberry Jam 

□ Saturday 8 December 
$ The Shed, Manchester, UK 

► magpi.cc/EJzNAv 

Attend this monthly Jam to take part in taught workshops 
or to get help working on your own projects. 


FULL CALENDAR 

Get a full list of upcoming 
events for December and 
beyond here: 

rpf.io/jam 


08. Yertx Raspberry Jam Colombia 

n Saturday 15 December 

Biblioteca Publica Virgilio Barco, Bogota, Colombia 

► magpi.cc/UXPSnm 

Meet others in this Jam to share knowledge 
and your projects based on Raspberry Pi. 


MatfPi I EVENTS 


02. FSSD Evening of Code 

H Thursday 6 December 

Freedom Intermediate School, Franklin, TN, USA 

► magpi.cc/bKFqKz 

The community is welcome to come and see what the 
students of Freedom Intermediate are Learning about 
computational thinking. 


Raspberry Jam 

Event Calendar 

Find out what community-organised Raspberry Pi-themed 
events are happening near you,.. 


01. Bognor Regis Raspberry Jam 

□ Saturday 1 December 
® University of Chichester, Bognor Regis, UK 
► magpi.cc/pVNTsb 

There will be a mix of show-and-tell presentations, along 
with tutorials and chances to tinker with Pi boards. 


05. Leeds Raspberry Jam 

n Wednesday 5 December 
$ Dixons Unity Academy, Leeds, UK 
► magpi.cc/KTqnnj 

Get hands-on with more digital making activities through 
the workshop, and a hackspace area to share projects. 


03. Christmas Raspberry Jam 

□ Saturday 8 December 
® Worksop College, Worksop, UK 

► magpi.cc/pZkWUP 

This Christmas-themed Raspberry Jam will have 
seasonal projects to see and play with. 

04. Raspberry Pi Jam Session & Code Carnival 

n Saturday 8 December 

<5> Third Place Commons, Seattle, WA, USA 

► magpi.cc/sxSbGA 

Join fellow coders, builders, and Raspberry Pi makers 
in an eight-hour, all-day event. 
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FIND OUT 
ABOUT JAMS 

Want a Raspberry Jam 
in your area? 

Want to start one? 
Email Ben Nuttall about it: 

jam@raspberrypi.org 


We've highlighted some of the areas 

i 

in need of a Jam! Can you help out? 


Raspberry Jam advice: 

Post event 


know Til need some good ideas 
to move beginners on, or they 
won’t return. I know I will have 
to advertise more widely to get the same 
number of people next time. People always 
come in greater numbers to the first of 
something new. ” 

Anne Cahill - York Raspberry Jam 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers and more. 
Get the book here: magpi.cc/2q9DHfQ 




m 
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Your 

Letters 




▲ Get yourself a Raspberry Pi 
3A+ when you subscribe to 
The MagPi for a year! 


A on the cover 


Educator discounts 


I 


Back issues 


With the announcement of the 
brand new Raspberry Pi 3A+ I 
was wondering whether you'd 
be doing anything special like 
putting it on the cover? 

I still use the Pi Zero I got 
with your magazine, and would 
love it if you could do it again! 
I’ll also be able to prepare 
to grab an extra copy before 
everyone rushes to the shops. 

Eve via email 

The Pi 3A+ is not being given 
away this issue, we’re afraid, 
and we don’t usually announce 
our free give-aways ahead of 
time either. Sorry! 

However, for this month 
only we have a very special 
subscription deal: if you take out 
a 12-month subscription to the 
magazine, you’ll get a Raspberry 
Pi 3A+ instead of the Pi Zero W 
bundle! You can find out more 
details about it on page 26. ED 


Contact us! 


> Twitter 

> Facebook 

> Email 

> Online 


@TheMagPi 

magpi.cc/facebook 

magpi@raspberrypi.org 

raspberrypi.org/forums 




Hi there, is there any sort 
of discount for schools to 
subscribe, by any chance? 

Dan via Twitter 

We’re currently in the process 
of creating a new educators 
discount for The MagPi, and 
possibly our sister magazines. 

We had not finalised it before 
we sent this issue to print 
- however, you can email 
rpipresshelp@raspberrypi.org 
and they should be able to help 
you out in some way. 

We’re happy to offer the 
discounted rate to educators, but 
remember that every issue is also 
available as a completely free 
PDF, which might work better in 
some classroom situations! ED 





► Educators shouLd aLso check out HeLLo 
WorLd, our sister magazine made 
specificaLLy for teachers: helloworld.cc 


Pm looking to complete my 
collection of back issues of The 
MagPi. Do you have any printed 
copies left of issues 31 onwards? 
Pd happily pay for them, as my 
shelf is looking a little empty! 

If not, when do you expect 
reprints to come in? 

Jerry via Facebook 

The best place to look for back 
issues is in our official store, 
store.rpipress.ee. Here you 
can find single issues of all 
our magazines. However, once 
they’re sold out, they tend to 
be gone forever. We rarely do 
reprints due to the way the 
magazine industry works. 

Also, issues 31 to 37 were never 
printed. However, with those and 
other issues, please feel free to 
download the PDFs and get them 
printed out for your collection. 

We only ask that you don’t sell 
these printed-out copies, as 
that goes against our Creative 
Commons licence. ED 

4 ALL available 
issues that are 
still in stock can 
be bought from 
our official store: 
store.rpipress.ee 



Raspberry Pi 


PRESS 


| magpi.ee | Your Letters 


















YOUR LETTERS I 


Free issues 


I have an almost complete set of The MagPi 
magazines from Christmas 2015 (issue 40) 
to September 2018 (issue 73), plus a 2018 Pi 
Annual. I will send them free to whoever wants 
them, but to one address in one parcel. Please 
email me if you would like them. 

Matthew from the forums 

Thanks for letting us know about this, 

Matthew - you can head to the Raspberry 
Pi forums, where he's posted his email 
address to take him up on his offer here: 

magpi. cc/UxPzgg. 

We also have a thread on The MagPi forum for 
listing any other magazines or books you might 
want to give away. You can find that thread 
here: magpi.cc/DDeWqi. E 1 



Please be aware that Matthew will likely 
not have the free gifts from some of our 
previous issues, like the AIY Voice Kit 





We're experts in uncompromising 
sound. HiFiBerry offers a wide 
range of sophisticated solutions 
for high-resolution music playback. 


Build a streaming player, create a 
media center, install a multi-room 
home system, or upcycle your 
favorite vintage speakers, 
there are no limits with our gear. 


What can we help you build today? 


www.hifiberry.com 








code 

club 


foflo 

C7 



CAN YOU HELP INSPIRE 


THE NEXT GENERATION 



OF CODERS? 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


We're always looking for people with coding skills to volunteer to 
run a club at their local school, library, or community centre. 


You can team up with friends or colleagues, you will be supported 
by someone from the venue, and we provide all the materials 
you'll need to help children get excited about digital making. 



To find out more, join us at 


www.codeclubworld.org 


ff 



Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 
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Raspberry Pi 
boards 


To celebrate the release of the brand new 
Raspberry Pi 3 A+ the first new Model A board 
in a while, we’ve got ten of them to give away, 
complete with ten of the brand new cases! What’s 
more, you'll get it signed by Eben Upton. How cool is that? 


3A+ 


Win one of ten 3A+ & cases, signed by Eben himself! 

Head here to enter: magpi.cc/win | Learn more: magpi.cc/3Aplus 


Terms & Conditions 

Competition opens on 29 November 2018 and closes on 20 December 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi 
Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner 
consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don’t like spam: 
participants’ details will remain strictly confidential and won’t be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted 
by email to arrange delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed 
or administered by, or associated with, Instagram or Facebook. 
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NEW 


Winsfram 





BKKOUTCLUB 


Join us as we lift the lid 
on video games 


LIFTING THE LID ON VIDEO GAMES 


NEW 


Cyberpunk 

2077 

Adapting tabletop" 
RPGs to video games 


yil | 

The changing face of VIDEO GAMES 
a console icon 


EXCLUSIVE 


Far Cry 4’s Alex Hutchinson 
bn his “louder, r 


olid Snake 


, brash'er’ game 


Metal Gear creator 
Hidco Kojima profiled 


Visit wfmag.ee to learn more 
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Surfing the learning curve 

Community Manager Ben Nuttall on removing barriers in digital making 


T he email said: “brain-picking, 
putting out feelers, other yucky 
metaphors.” It arrived in my 
inbox on 8 October 2013. The sender: 
Liz Upton. The three-strong Raspberry 
Pi Foundation wanted to increase their 
staff numbers to four and apparently 
had a Ben Nuttall-shaped hole to fill. 

IT1 never forget that moment - I 
was sitting at my desk at my day job 
in Manchester, making website after 
website. It seemed Liz had noticed 
I was quite fond of the Raspberry 
Pi and thought my combination 
of web development skills, and 
experience setting up and running 
the Manchester Raspberry Jam, would 


Technologists programme; I met 
the Prime Minister of Estonia at a 
hackathon; I helped launch the new 
digital maker Scouts badge; I support 
Raspberry Jams worldwide; and I 
recently upgraded our Astro Pi units 
on the International Space Station to 
Raspbian Stretch. 

Skills for life 

Our partnership with The Scout 
Association is very close to my heart 
- I lived through the whole Scouting 
movement from age six to nineteen, 
and it helped me develop skills for life. 
I love the idea that today’s Beavers, 
Cubs, and Scouts will get the chance 


□ I love the idea that today's Beavers, Cubs, 
and Scouts will get the chance to include 
digital making in their experience □ 


come in handy at Pi Towers (then, a 
humble single-room office). I jumped 
at the chance, and became a resident 
of Cambridge in November, five years 
ago this month. In my time, I’ve seen 
us launch a dozen or so new hardware 
products, grow to over 100 staff, and 
we’ve just moved into our fourth 
office (where incidentally, I host the Pi 
Towers Raspberry Jam). 

As we’ve grown and developed, so 
has my role. I helped launch Picademy; 
I revamped raspberrypi.org, and our 
first projects site; I ran the Creative 


to include digital making in their 
Scouting experience, and hope that 
they see the relevance of technology 
in their adventure-filled lives. 

Lots of people and organisations 
in tech talk about making learning 
coding and computing ‘easy’. I don’t 
necessarily think this is the right 
attitude to take. I believe in removing 
barriers to entry and smoothing the 
learning curve, making things more 
accessible, not just easy. GPIO Zero 
aims to make it easier to get started 
with physical computing, and helps 


make the code more approachable 
to read, write, and understand, but 
there’s no end to where you can take 
it - you can do some really advanced 
stuff, and your code is beautifully 
succinct, not a plate of copy-pasted 
spaghetti code you cherry-picked from 
Stack Overflow. A few people have 
asked me recently about how they 
can use GPIO Zero to show and teach 
what’s going on underneath and I’ve 
demonstrated how they can use the 
low-level classes in GPIO Zero to get 
the best of both worlds, which seems 
to have gone down well. 

Another project I created to help 
remove barriers is piwheels, which 
makes pip install fast. The principle 
is simple - we automate compiling all 
Python packages on Raspberry Pi 3s 
(provided by the Mythic Beasts Pi 
Cloud), and provide them for download 
(on a Pi running a web server). 

This Pi currently serves over half a 
million packages per month, which 
in the last twelve months has saved 
Raspberry Pi users a total of 32 years 
of build time - that’s more than my 
lifetime! This project also helped bring 
Google’s machine-learning framework 
TensorFlow to the Raspberry Pi. ED 



Ben Nuttall 


Raspberry Pi's Community Manager, creator 
of GPIO Zero and piwheels, Jam master, and 
the Foundation's resident Python expert! 

bennuttall.com 
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RASPBERRY PI 

EG INNER'S BOOK 

IS 


LEARN 

COMPUTING 

THE EASY WAY! 


Inc uaes 


Pi Zero W computer 
Official case with three covers 
USB and HDMI adapters 
8 GB microSD card 
116 -page beginner’s book 


Buy online: magpi.cc/store 












a TM 

Cano Kit 




Learn to: 

Build your own credit card 
sized computer 

^ Get started with programming 
^ Set up a Media Center 

^ Make simple electronic circuits 
Includes: 

Raspberry Pi board and case 

-o: ~ Memor yc«d 

^fiocnh ° n,CpartS 

^ WWtfor0umnifeBook|et 


Kit Includes: 

u* Raspberry Pi 

For Dummies Booklet 

Raspberry Pi 3 Board 

Memory Card 

u 0 Plastic Case 

u 0 2.5A Power Supply 

HDMI Cable 

u 0 Resistors 

LEDs 

u 0 Push Button Switches 
u 0 Prototyping Breadboard 
u 0 Jumper Wires 
u 0 Heat Sinks 



Available for worldwide shipping at: 

WWW.CANAKIT.COM 



Available in Europe 
through RS Components 


m 




$89" £69" 

US DOLLARS EXCLUDING VAT 



Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 
a registered trademark of RS Components Ltd. CanaKit is a registered 
trademark of Cana Kit Corporation. 
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